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 or X | 1 |
| Ad from Google | 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, 15 on LinkedIn), however many ads it returns |
| Domain resolve with at least one match | 10 |
| Domain check | 3 |
| Advertiser stats | 5 |
| Advertiser record | 1 |
| Timeline or change event | 1 |
| Cached result (under 24 hours), empty result, upstream error, timeout | 0 |
Some endpoints are always free, for example domain suggestions, resolve reports 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.
Plans and packs
Plans include monthly credits that reset at the start of each billing month and don't roll over. Credit packs are one-off, valid for 12 months, usable on any plan and used after the monthly credits. Prices are on the pricing page.
When the monthly credits and packs are used up, the API answers 429 quota_exceeded. Don't retry; buy a pack or wait for the next month.