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
Get your free API key

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.

EndpointWhat you getCredits
GET /v1/ads/searchSearch ads1 credit per 10 ads returned, rounded up
GET /v1/pages/{page_id}/adsAds of an advertiser1 credit per 10 ads returned, rounded up
GET /v1/pages/searchSearch advertisers1 credit per 10 pages returned, rounded up
GET /v1/ads/{ad_id}Ad details with EU transparency data2 credits
GET /v1/pages/{page_id}Advertiser page1 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.

CreditsPricePer 1,000 creditsYou save
10,000$9$0.9010%
100,000$80$0.8020%
1,000,000$700$0.7030%
10,000,000$5,000$0.5050%

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.