Facebook (Meta) Ad Library API
Meta's official Ad Library API only covers political and social-issue ads. This connector returns commercial ads too — search by keyword, advertiser page or Ad Library URL and get the copy, creatives, call to action, run dates, platforms and status.
From $0.0008 per ad · no API key · failed calls refunded
What you get
- Ad copy, headline and call to action
- Image and video creatives
- Start and end dates and active status
- Platforms: Facebook, Instagram, Messenger, Audience Network
- Filter by country, media type and date range
Just ask your AI
“Show me every active ad from Athletic Greens in the US and summarise their hooks.”
“Which competitors are advertising 'meal kit' in Australia right now, and what offers do they use?”
Connectors behind it
Your AI picks the right one for the question. Each is priced per result and refunded if it fails.
queryqueryTypeadArchiveIdadLibraryUrlisActivestartDateGoogle Ads Transparency Scraper$0.0005 per resultScrape every Google ad creative for any advertiser or domain — image, text, and video ads with run dates, regions, and asset URLs.advertiserIdadvertiserNameadvertiserDomaincreativeIdformatformatCodeTikTok Ad Library Scraper$0.01 per adScrape every TikTok ad an advertiser is running — video/image creatives, ad copy, run dates and estimated audience — straight from the public ad library.adIdadLibraryUrladvertiserresolvedAdvertiserNameadTextimageUrlUse the Facebook Ad Library API from Claude, ChatGPT or Cursor
Pick your tool and connect in under a minute. Then just ask — for example: “Show me every active ad from Athletic Greens in the US and summarise their hooks.”
Connect Claude
Web, desktop and mobile. One click, then confirm.
- 1Click Add to Claude — claude.ai opens with Sourcelane filled in
- 2Click Continue to confirm — it then works in Claude desktop and mobile too
Manual setup (config files, REST, Python) +
Claude Code
Adds the Sourcelane MCP server with your key as a header.
claude mcp add --transport http sourcelane https://api.usesourcelane.com/mcp \
--header "Authorization: Bearer sl_live_your_agent_key"Claude Desktop (config file)
Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.
{
"mcpServers": {
"sourcelane": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.usesourcelane.com/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer sl_live_your_agent_key"
}
}
}
}Cursor & Windsurf
Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).
{
"mcpServers": {
"sourcelane": {
"url": "https://api.usesourcelane.com/mcp",
"headers": {
"Authorization": "Bearer sl_live_your_agent_key"
}
}
}
}VS Code
Save as .vscode/mcp.json. VS Code prompts for your key once.
{
"servers": {
"sourcelane": {
"type": "http",
"url": "https://api.usesourcelane.com/mcp",
"headers": {
"Authorization": "Bearer ${input:sourcelane-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "sourcelane-key",
"description": "Sourcelane agent key",
"password": true
}
]
}ChatGPT Custom GPT (Actions)
Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.
https://usesourcelane.com/openapi.jsonREST
One POST. Pass maxResults to cap cost.
curl -X POST https://api.usesourcelane.com/v1/call \
-H "Authorization: Bearer sl_live_your_agent_key" \
-H "Content-Type: application/json" \
-d '{"listing":"meta-ad-library-scraper","params":{"keywords":["lululemon"],"maxAdsPerQuery":5},"maxResults":10}'Python, LangChain, CrewAI, OpenAI Agents SDK…
Wrap the REST call as a tool, or point an MCP client at the endpoint.
import requests
res = requests.post(
"https://api.usesourcelane.com/v1/call",
headers={"Authorization": "Bearer sl_live_your_agent_key"},
json={
"listing": "meta-ad-library-scraper",
"params": {"keywords":["lululemon"],"maxAdsPerQuery":5},
"maxResults": 10,
},
timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])Facebook Ad Library API — FAQ
Does it include non-political ads?+
Yes. It covers all ads shown in the public Meta Ad Library, not just political ones.
Do I need a Ad Library API key or developer account?+
No. Sourcelane runs the connectors for you. You top up a balance with a card, create an agent key, and your agent calls the connector — there is no Ad Library app review, OAuth setup or rate-limit juggling on your side.
Which AI tools can use it?+
Anything that speaks MCP (Claude Desktop, Claude Code, Cursor, VS Code, Windsurf) can connect to the Sourcelane MCP server with one config block. ChatGPT can use it through a Custom GPT Action, and any agent framework can call the REST endpoint directly.
Can I stop an agent from overspending?+
Yes. Every agent key has its own per-call cap, daily and monthly limits, an optional lifetime budget, an allowlist of connectors, and a kill switch.
