Docs

Credits and billing

How AdLib bills: credits per delivered result by platform, capped search pages, what is free, plan credits and credit packs.

You pay credits for results we deliver, not for requests. Empty results, cached results and upstream errors are free.

What costs what

Result Credits
Ad from Meta, TikTok, Pinterest, X, Snapchat, Apple App Store, Amazon or Microsoft Bing 1
Ad from Google, YouTube or Google Play 2
Ad from LinkedIn 3
Archived ad last shown more than 12 months ago double the above
Live search page at most 5 per platform (10 on Google, YouTube and Play, 15 on LinkedIn), however many ads it returns
Domain resolve with at least one match 10
Domain check (/v1/domains/{domain}/check, all platforms) 3
Creative features of one ad (/v1/ads/{id}/features) 2, plus the ad if it has to be fetched live
Advertiser stats 5
Advertiser record 1
Timeline or change event 1
Watchlists: adding brands, the scheduled checks, alert emails and webhook deliveries 0
Cached result (under 24 hours), empty result, upstream error, timeout 0

Watchlists themselves cost no credits; the plan limits how many brands they watch, over all watchlists, Studio's included. Reading their change events through the API costs 1 credit per event.

Some endpoints are always free, for example /v1/library-url, domain suggestions, resolve reports, the takedown feed and your own usage. Their reference pages say so.

See what a call cost

Every response has an X-Billing-Credits header. GET /v1/usage returns your credits per day and endpoint.

Check your balance

GET /v1/account returns your plan, the credits you have left, each credit pack with the date it expires, and your limits. It is free and still answers when you have no credits left. /v1/credits returns the same.

Shell
curl "https://api.adlibapi.com/v1/account" -H "X-API-Key: $ADLIB_API_KEY"
JSON
{
  "email": "[email protected]",
  "plan": "api",
  "credits_left": 48210,
  "free_credits": 0,
  "pack_credits": 48210,
  "credits_used_this_month": 1790,
  "credit_packs": [{ "pack": "api-50k", "credits": 50000, "remaining": 48210, "bought_at": "2026-11-02T09:14:00Z", "expires_at": "2027-11-02T09:14:00Z" }],
  "limits": { "requests_per_minute": 300, "max_batch_items": 100, "watchlist_brands": 250, "watched_brands": 12, "history_days": 0, "min_interval_hours": 6 }
}

Free credits and packs

The API is prepaid, with no subscription. A new account gets 2,000 free credits once; after them you buy credit packs, which stay valid for 12 months (the pack that expires first is used first). Your first pack also lifts the account's limits: 300 requests a minute, batches of 100 and 250 watched brands. Prices are on the pricing page.

AdLib Studio, the web app, is a separate monthly plan with its own credits; they don't pay for API calls, and API credits don't pay for Studio.

When the credits are used up, the API answers 429 quota_exceeded. Don't retry; buy a pack in the dashboard and the key works again right away.