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. A new account gets 2,000 free credits once, no card needed. Create a key in the dashboard under Keys; it is shown once, so store it right away.
export ADLIB_API_KEY="your-key"2. Find a company's ad accounts
Resolve a domain to its advertisers on all twelve platforms:
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:
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:
curl "https://api.adlibapi.com/v1/usage" -H "X-API-Key: $ADLIB_API_KEY"5. Get told when they change
Put the advertiser on a watchlist and the next new, stopped, changed or removed ad lands in Slack (or Discord, your own endpoint, or your inbox):
curl -X POST "https://api.adlibapi.com/v1/watchlists" \
-H "X-API-Key: $ADLIB_API_KEY" -H "Content-Type: application/json" \
-d '{"name": "Nike", "advertisers": ["meta:15087023444"], "webhook_url": "https://hooks.slack.com/services/...", "email_alerts": true}'Next steps
- Search across platforms with
GET /v1/search, or the archive withsource=history. - See why an ad works: Creative features.
- Alerts in detail, with signed webhooks: Watchlists and webhooks.
- Use it from Claude or Cursor: MCP for AI agents.