Docs

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=youtube or platform=play returns only YouTube or Google Play ads from Google's Transparency Center (same as placement=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 into GET /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
Google 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
LinkedIn Ad Library Keyword, company, domain
Pinterest 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.