Ad Libraries API
Public ad-library data from Meta, Google, LinkedIn and TikTok in one API.
Search the public Meta, Google, LinkedIn and TikTok ad libraries by advertiser or keyword and get creatives, run dates and Meta spend data as JSON.
- Endpoints
- 19
- Pricing
- Free tier · paid from $25/mo
- Access
- REST · MCP · x-api-key
- Data
- Public only · real-time · zero retention
Ad Libraries
Ad Search
/ad_libraries/tiktok_ads/tiktok_ads_searchDescription
Ad Search
Parameters
query(string)the search query
country(string)start_time(number)in milliseconds
end_time(number)in milliseconds
search_id(string)order(string)Code Snippet
curl --request GET \
--url 'https://api.brizzox.com/ad_libraries/tiktok_ads/tiktok_ads_search' \
--header 'x-api-key: YOUR_API_KEY'Example Response
About the
Ad Libraries API
The Ad Libraries API returns the public advertising-transparency data that Meta, Google, LinkedIn and TikTok publish, as clean JSON. Search ads by advertiser, keyword or page, pull the full details of a single ad, and read Meta spend breakdowns by advertiser and location — 19 endpoints across the four libraries.
Every request is fetched live from the platform's public library at the moment you call it. Brizzox stores no ad creatives, no advertiser records and no request payloads (zero data retention), so what you receive is the freshest public copy of the ad, not a stale mirror.
Authenticate with a single x-api-key header, start on the free Basic tier, and call the same endpoints from Claude, Cursor or any MCP client using the Brizzox MCP server.
What you can do
- Meta Ad Library: advertiser search, ad search, ad details, spend by advertiser, spend and top-spend by location, page URL → page ID, dynamic filter options
- Google Ads Transparency Center: ads by advertiser, ad details, advertiser autocomplete
- LinkedIn Ad Library: ad search, ad details, supported country codes
- TikTok Ad Library: ad search and ad details
- Real-time fetch on every call — no cached creatives, zero data retention
All 19 endpoints
Grouped by resource. Open a group to see every operation; select one in the console above to try it.
tiktok-ad-library (2)
- Ad Search
GET /ad_libraries/tiktok_ads/tiktok_ads_search - Ad Details
GET /ad_libraries/tiktok_ads/{ad_id}/details
linkedin-ad-library (3)
- Search LinkedIn ads
GET /ad_libraries/linkedin_ads/linkedin_ads_search - LinkedIn ad details
GET /ad_libraries/linkedin_ads/{ad_id}/details - Get LinkedIn ad country codes
GET /ad_libraries/linkedin_ads/country_codes
google-ad-library (3)
- Search Google ads
GET /ad_libraries/google_ads/google_ads_by_advertiser - Ad Details
GET /ad_libraries/google_ads/google_ads_details - Autocomplete Google ads
GET /ad_libraries/google_ads/google_ads_autocomplete
meta-ad-library (11)
- Top Spending by locations
GET /ad_libraries/meta_ads/meta_top_spend_by_locations - Spend by locations
GET /ad_libraries/meta_ads/meta_spend_by_locations - Spend by advertisers
GET /ad_libraries/meta_ads/meta_spend_by_advertisers - Convert Facebook page URL to page ID
GET /ad_libraries/meta_ads/page_url_to_id - Meta ad search filter options
GET /ad_libraries/meta_ads/dynamic_filter_options - Search advertisers
GET /ad_libraries/meta_ads/meta_advertisers - Advertiser page details
GET /ad_libraries/meta_ads/meta_advertiser_page/{page_id}/details - Advertiser page ads
GET /ad_libraries/meta_ads/meta_advertiser_page/{page_id}/ads - Advertiser page ads
POST /ad_libraries/meta_ads/meta_advertiser_page/{page_id}/ads - Search ads
GET /ad_libraries/meta_ads/meta_ads - Search ads
POST /ad_libraries/meta_ads/meta_ads
Use cases
Competitive ad intelligence
Track which creatives, hooks and landing pages a competitor is running across Meta, Google, LinkedIn and TikTok without maintaining four scrapers.
Ad-spend research
Use Meta's spend-by-advertiser and spend-by-location endpoints to size markets and benchmark political or issue advertising.
Creative libraries for agencies
Feed live ad examples into internal swipe files, pitch decks or AI assistants via MCP.
Pricing
Each plan includes a monthly allowance of credits, which your calls spend at each endpoint's set cost.
- basic$0/mo · 50 credits · 60 req/min
- pro$25/mo · 10,000 credits · 250 req/min
- ultraMost popular$75/mo · 50,000 credits · 500 req/min
- mega$150/mo · 200,000 credits · 1000 req/min
Frequently asked
questions
Is this the official Meta Ad Library API?
No. Brizzox reads the public ad libraries that the platforms publish for transparency and returns them in one consistent JSON shape, with no approval process or platform developer app required. It is not affiliated with Meta, Google, LinkedIn or TikTok.
How fresh is the data?
Each call is executed live against the public library when you make it. Brizzox does not cache or store the results.