Ad Library API pricing
Start with 100 free credits every month. Then pay $1 per 1,000 credits, for the data you get back and only for the calls that succeed.
Pay as you go
That is 10,000 ads in search results.
$1/ 1,000 credits
- 100 free credits every month, no credit card
- $1 per 1,000 credits, top up any amount from $5
- You pay per item returned, not per request
- Only successful calls are billed: errors cost nothing
- Credits never expire, no subscription, no monthly minimum
- Every endpoint: ad search, ad details with EU transparency data, advertiser pages and their ads
Pay per item, not per request
Lists cost in proportion to what they return, so a page with a few ads costs less than a full one.
| Endpoint | What you get | Credits |
|---|---|---|
| GET /v1/ads/search | Search ads | 1 credit per 10 ads returned, rounded up |
| GET /v1/pages/{page_id}/ads | Ads of an advertiser | 1 credit per 10 ads returned, rounded up |
| GET /v1/pages/search | Search advertisers | 1 credit per 10 pages returned, rounded up |
| GET /v1/ads/{ad_id} | Ad details with EU transparency data | 2 credits |
| GET /v1/pages/{page_id} | Advertiser page | 1 credit |
Errors are free. Example: a search returning 30 ads costs 3 credits; 25 ads cost 3 credits; 4 ads cost 1 credit; no results, no charge.
Bulk packs
One-time purchase, no commitment. Bulk credits never expire.
| Credits | Price | Per 1,000 credits | You save |
|---|---|---|---|
| 10,000 | $9 | $0.90 | 10% |
| 100,000 | $80 | $0.80 | 20% |
| 1,000,000 | $700 | $0.70 | 30% |
| 10,000,000 | $5,000 | $0.50 | 50% |
Billing questions
- How are credits counted?
- By what you get back. A list of ads costs 1 credit for every 10 ads returned, rounded up: a page of 30 ads costs 3 credits, a page of 7 ads 1 credit, and a search with no results costs nothing. An ad with its full details costs 2 credits and an advertiser page 1. Every response tells you what it cost in credits_used and the X-Credits-Used header.
- How much is that per ad?
- At the base price of $1 per 1,000 credits, $1 buys 10,000 ads in search results, that is $0.10 per 1,000 ads. Bulk packs bring it down to as little as $0.05 per 1,000 ads.
- Am I charged for errors or empty results?
- No. Requests that fail, for example because an ad does not exist or the Ad Library is temporarily unavailable, cost no credits, and neither does a search that returns no results. If your balance is low, the API lowers the page size so a request never costs more than you have.
- Do credits expire?
- No. Pay-as-you-go top-ups and bulk packs never expire, and the 100 free credits are renewed on the 1st of every month.
- Is there a subscription?
- No subscription is needed: you buy credits when you need them.
Ready to build? Read the getting started guide or the API reference.