Introduction
AdLib is one REST API over the public ad libraries of Meta, Google, YouTube, Google Play, TikTok, LinkedIn, Pinterest, X, Snapchat, the Apple App Store, Amazon and Microsoft Bing, with an archive of ads the platforms no longer show.
AdLib reads the public ad libraries of twelve platforms and returns every ad in the same format. Ads we have seen stay in our archive with their dates and creatives, also after the platform hides them.
What you can do
- Find a company's ad accounts from its domain on every platform: From a domain to advertisers.
- Search ads by keyword, advertiser, domain, country, date and format across platforms:
GET /v1/search.platform=youtubeorplatform=playreturns only YouTube or Google Play ads from Google's Transparency Center (same asplacement=youtube). - See what a company runs and who runs it for them: one call for every ad account of a domain, with own accounts separated from agencies and resellers (
GET /v1/companies/{domain}), or a yes/no per platform for lead lists (GET /v1/domains/{domain}/check, 3 credits). - Read the history of an ad or an advertiser, including ads that ended and ads the platforms removed from their libraries (
removed_from_library_at,source=history&removed=true): Ad history and the archive. - Know why an ad works: video length, aspect ratio, cuts, sound, on-image text, offers, urgency and the hook, plus
derived.stage(testing, scaling, proven) on every ad: Creative features. - Get told when a competitor moves: watchlists send new, stopped, changed and removed ads to a signed webhook, a Slack or Discord channel, or your inbox: Watchlists and webhooks.
- Measure EU reach over time for Meta ads shown in the EU: EU reach over time.
- Let an AI agent use it through the hosted MCP server: MCP for AI agents.
- Export to a sheet with
output=csv, paste any ad library link intoGET /v1/library-url, or call the API from Clay, n8n, Make or Zapier with an HTTP step: n8n, Clay and no-code. - Run many lookups as one job: Batch jobs.
Platforms
| Platform | Library | Search by |
|---|---|---|
| Meta | Facebook & Instagram Ad Library | Keyword, page, domain |
| Ads Transparency Center (Search, Shopping, Maps) | Advertiser, domain, placement |
|
| YouTube | Google Ads Transparency Center, platform=youtube |
Advertiser, domain |
| Google Play | Google Ads Transparency Center, platform=play |
Advertiser, domain |
| TikTok | Ad Library (EU, UK, CH) | Keyword, advertiser |
| Ad Library | Keyword, company, domain | |
| Ads Repository (EU) | Advertiser, domain | |
| X (beta) | Ads Repository (EU) | Handle, domain |
| Snapchat | Ads Gallery (EU) | Paying advertiser, domain; impressions per EU country |
| Apple App Store | Ad Repository (EU) | Developer, app name, domain; placement in the App Store |
| Amazon | Ad Library (EU stores) | Keyword, advertiser, domain; reach per country |
| Microsoft Bing (beta) | Ad Library (EU/EEA) | Keyword, advertiser, domain; impressions share per country |
Details per platform: Platforms.
Basics
| Base URL | https://api.adlibapi.com |
| Authentication | X-API-Key: <your key> header |
| Format | JSON, one schema for all platforms |
| Ids | <platform>:<platform id>, for example meta:15087023444 |
| Billing | Credits per delivered result; empty results and errors are free |
| Spec | OpenAPI 3.1 |
Start with the Quickstart: a free key and your first request take two minutes.