AdLib

Built for

Go to dashboardLog inStart free

Docs

Quickstart

Get a free API key and make your first AdLib requests: find Nike's ad accounts, then fetch their ads.

1. Get a key

Sign up with your email. New accounts get 1,000 free credits, no card needed. Create a key in the dashboard under Keys; it is shown once, so store it right away.

Shell
export ADLIB_API_KEY="your-key"

2. Find a company's ad accounts

Resolve a domain to its advertisers on all six platforms:

Shell
curl "https://api.adlibapi.com/v1/advertisers/resolve?domain=nike.com" \
  -H "X-API-Key: $ADLIB_API_KEY"

Each result has an id such as meta:15087023444, a score from 0 to 1 and a match_reason. This call costs 10 credits when it finds at least one match.

3. Fetch the ads

Use an advertiser id to list its ads:

Shell
curl "https://api.adlibapi.com/v1/advertisers/meta:15087023444/ads?status=active" \
  -H "X-API-Key: $ADLIB_API_KEY"

Every ad has the same fields on every platform: text, media, dates, countries and, where the platform publishes it, EU reach and targeting. See The ad object and ids.

4. Check what it cost

Every response carries the credits it used in X-Billing-Credits. Your usage per day and endpoint:

Shell
curl "https://api.adlibapi.com/v1/usage" -H "X-API-Key: $ADLIB_API_KEY"

Next steps