Dynamic ads API

The Dynamic Ads API allows advertisers to programmatically push domain listings to NamePros, where they'll be displayed in designated ad positions. This is ideal for:

• Domain marketplaces wanting to promote inventory
• Auction platforms showing live auction data
• Registrars highlighting premium domains

Key Concepts

• Campaign – A container for your listings with branding (logo, theme color) and a tracking tag. You can create and manage campaigns via the API.
• Listing – An individual domain advertisement within a campaign. You create, update, and delete listings via the API.

All API requests require authentication via an API key.

Getting an API Key

Contact NamePros to obtain an API key with the following scopes:

• np_ads_listings:read - Read campaigns and listings
• np_ads_listings:write - Create, update, and delete listings

Using the API Key

Include your API key in the XF-Api-Key header:

curl -H "XF-Api-Key: YOUR_KEY" \
  https://www.namepros.com/api/v1/ads/campaigns

Base URL

All API requests use the following base URL:

https://www.namepros.com/api/v1/

Example Requests

Create a campaign:

curl -X POST \
  -H "XF-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "horizontal_logo_url": "https://example.com/logo-wide.png",
    "vertical_logo_url": "https://example.com/logo-tall.png",
    "theme": "#ff5500",
    "logo_action": "https://example.com"
  }' \
  https://www.namepros.com/api/v1/ads/campaigns

Logo images are automatically downloaded, sanitized, and re-hosted on the NamePros CDN.

List your campaigns:

curl -H "XF-Api-Key: YOUR_API_KEY" https://www.namepros.com/api/v1/ads/campaigns

Create a new listing:

curl -X POST \
  -H "XF-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "ad_expires_at": 1735689600,
    "action_label": "Buy Now",
    "action_url": "https://example.com/buy?utm_source=namepros"
  }' \
  https://www.namepros.com/api/v1/ads/campaign/1/listing

You can preview how your campaign will look on the site at:

https://www.namepros.com/ads/listings/{campaign_tag}.{campaign_id}/preview

For example:

https://www.namepros.com/ads/listings/YourCompany2024.123/preview

The preview page shows your campaign rendered at the actual ad sizes used on the site:

• Above/below content — the wide banner that appears above and below page content
• Header (600 × 75) — the banner shown in the site header
• Sidebar — the smaller unit shown in the sidebar

You must be logged in to view the preview. You can preview your own campaigns; staff can preview any campaign.

For API access, questions, or issues, contact the NamePros team.