OpenAdLibraryOpenAdLibrary
FeaturesTrackDevelopersPricingBlog
EN
EnglishEspañolPortuguês (Brasil)FrançaisDeutschItalianoNederlandsPolskiSvenskaTürkçeРусский日本語한국어简体中文Tiếng ViệtBahasa Indonesia繁體中文ČeštinaDanskNorsk (bokmål)SuomiΕλληνικάRomânăMagyarУкраїнськаไทยहिन्दीالعربيةעברית
Log inStart free
FeaturesTrackDevelopersPricingBlog
EN
EnglishEspañolPortuguês (Brasil)FrançaisDeutschItalianoNederlandsPolskiSvenskaTürkçeРусский日本語한국어简体中文Tiếng ViệtBahasa Indonesia繁體中文ČeštinaDanskNorsk (bokmål)SuomiΕλληνικάRomânăMagyarУкраїнськаไทยहिन्दीالعربيةעברית
Log in
Help center

OpenAdLibrary API and MCP documentation

Query the public ad catalogue programmatically with the same leak-safe data available in the product.

Help topics

  • Getting started
  • Search & filters
  • API & developers
  • Methodology
  • FAQ

Create and protect an API key

Create a key from Settings. A key is shown once when it is created, so store it securely and revoke it if it is exposed.

Authenticate requests

Send the key in the x-api-key header or as Authorization: Bearer <key>. The same key can authenticate the REST API and the hosted MCP endpoint.

REST API

The public API exposes leak-safe ad-library fields and supports filtering and pagination. It also publishes the redirect chain behind an ad — the tracker URL the click starts on, every hop it passes through, and the advertiser URL it ends on — through /api/v1/ads/{id}/chain, /api/v1/chains/{chainHash} and /api/v1/chains/match. Chain URLs are credential-scrubbed, while attribution parameters such as subid, click_id and utm_* stay intact. The API does not expose private account data or internal identifiers. The interactive reference loads on this page when JavaScript is available.

Quotas and responses

Ad data and research over the API and MCP are part of the Founders plan. A key that belongs to a Free account gets 402 Payment Required for those requests. Each key has a daily request quota, shown beside your keys in Settings. Over that quota, or when requests arrive too fast, the API returns 429 Too Many Requests.

Hosted MCP endpoint

The hosted MCP server is https://mcp.openadlibrary.com/mcp. In Claude or ChatGPT, add it as a connector and choose Connect, then sign in with your OpenAdLibrary account and approve access; the connection creates its own API key. In Claude Code, run claude mcp add --transport http openadlibrary https://mcp.openadlibrary.com/mcp, then /mcp to sign in. Other MCP clients can send an API key as Authorization: Bearer <key>. Machine-readable documentation is also available in llms.txt and llms-full.txt.


OpenAdLibraryOpenAdLibrary

Ad intelligence for media buyers and affiliates. Search millions of Meta, TikTok, Google and native ads, trace the funnel behind each native ad, and track your own campaigns.

Product

Ad LibraryCreative StudioTrackBrand ProtectionExploreAPI & MCPAffiliate program

Company

AboutPricingChangelogContact

Resources

BlogAd-tech glossaryHelp centerAPI & MCP docsFAQCapture & click policy

Legal

PrivacyTermsCancel contract here
© 2026 OpenAdLibrary. All rights reserved.R & R DIGITAL PTY LTD (ABN 21 669 442 602) · Brisbane, Australia
OpenAdLibrary