Facebook Ad Library search by keyword — every live and recent ad matching a search term ac
Facebook Ad Library search by keyword — every live and recent ad matching a search term across all advertisers on Facebook, Instagram, Messenger and Threads. Returns the full ad creative (headline, body copy, CTA button + destination link, image and video URLs), the advertiser, run dates and days-running, and platform mix. Commercial and political ads, no Meta API or login. Competitor ad intelligence, ad spy, and creative research for AI agents.
30000 (raw units)
price
4
calls / 30d
4
unique payers
2026-09-18
updated
Provider
ads.apitoll.cloud · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x4ce88238F669d04351937420C931988e464a975a",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "30000",
"maxTimeoutSeconds": 150
},
{
"scheme": "exact",
"network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
"payTo": "HZ5rN5HmZpu2H16auY5Zt5SuJjCMBG77odVhAVSuhK1x",
"asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"amount": "30000",
"maxTimeoutSeconds": 150
}
]Output schema
{
"bazaar": {
"info": {
"input": {
"method": "GET",
"queryParams": {
"country": "US",
"q": "running shoes"
},
"type": "http"
},
"output": {
"example": {
"ads": [
{
"adArchiveId": "1234567890123456",
"bodyText": "Lightweight cushioning for your longest runs. Free shipping this week.",
"country": "US",
"ctaText": "Shop Now",
"ctaType": "SHOP_NOW",
"daysRunning": 28,
"displayFormat": "VIDEO",
"imageUrls": [
"https://scontent.xx.fbcdn.net/v/img1.jpg"
],
"isActive": true,
"linkUrl": "https://acmefootwear.com/aeroglide?utm_source=fb",
"linkUrlType": "destination",
"mediaExpiresAt": "2026-06-29T22:19:28Z",
"pageId": "100066543210987",
"pageName": "Acme Footwear",
"pageVerified": true,
"publisherPlatform": [
"FACEBOOK",
"INSTAGRAM"
],
"scrapedAt": "2026-06-25T14:32:09Z",
"sourceUrl": "https://www.facebook.com/ads/library/?q=running%20shoes&country=US",
"startDate": 1717200000,
"templatedText": false,
"title": "Run Further in the new AeroGlide",
"videoUrl": "https://video.xx.fbcdn.net/v/ad_hd.mp4"
}
],
"asOf": "2026-06-25T14:32:10Z",
"count": 25,
"country": "US",
"query": {
"keyword": "running shoes"
},
"source": {
"name": "Facebook Ad Library",
"via": "Apify"
}
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"active_status": {
"description": "Filter by whether the ad is still running.",
"enum": [
"all",
"active",
"inactive"
],
"type": "string"
},
"ad_type": {
"description": "Ad category filter. political_and_issue_ads MAY add spend + impressions ranges when Meta discloses them (often absent).",
"enum": [
"all",
"political_and_issue_ads",
"housing_ads",
"employment_ads",
"credit_ads",
"financial_products_and_services_ads"
],
"type": "string"
},
"country": {
"description": "Two-letter ISO country (US, GB, DE, BR…) the ads target, or ALL for a bounded multi-region sweep (slower). Default US.",
"type": "string"
},
"limit": {
"description": "Max ads to return (1-60).",
"maximum": 60,
"minimum": 1,
"type": "integer"
},
"media_type": {
"description": "Creative format filter.",
"enum": [
"all",
"image",
"video",
"meme",
"image_and_meme",
"none"
],
"type": "string"
},
"period": {
"description": "Limit to ads active in this window. Blank = all time.",
"enum": [
"",
"last24h",
"last7d",
"last14d",
"last30d"
],
"type": "string"
},
"platforms": {
"description": "Comma-separated publisher filter: FACEBOOK,INSTAGRAM,MESSENGER,AUDIENCE_NETWORK,THREADS,WHATSAPP. Blank = all.",
"type": "string"
},
"q": {
"description": "Keyword/phrase to search ads for (e.g. \"running shoes\", \"crypto wallet\"). Defaults to a demo query if omitted.",
"type": "string"
},
"resolve_advertiser": {
"description": "Also resolve each advertiser’s page identity (verified status, categories, profile pic). Slower. Default false.",
"type": "boolean"
},
"sort_by": {
"description": "most_recent (newest/currently-running first — default) or impressions_desc (all-time highest-impression ads, often older/ended).",
"enum": [
"impressions_desc",
"most_recent"
],
"type": "string"
}
},
"required": [
"q"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"ads": {
"items": {
"properties": {
"adArchiveId": {
"type": "string"
},
"bodyText": {
"type": "string"
},
"country": {
"type": "string"
},
"ctaText": {
"type": "string"
},
"ctaType": {
"type": "string"
},
"daysRunning": {
"type": "number"
},
"displayFormat": {
"type": "string"
},
"imageUrls": {
"items": {
"type": "string"
},
"type": "array"
},
"isActive": {
"type": "boolean"
},
"linkUrl": {
"type": "string"
},
"linkUrlType": {
"type": "string"
},
"mediaExpiresAt": {
"type": "string"
},
"pageId": {
"type": "string"
},
"pageName": {
"type": "string"
},
"pageVerified": {
"type": "boolean"
},
"publisherPlatform": {
"items": {
"type": "string"
},
"type": "array"
},
"scrapedAt": {
"type": "string"
},
"sourceUrl": {
"type": "string"
},
"startDate": {
"type": "number"
},
"templatedText": {
"type": "boolean"
},
"title": {
"type": "string"
},
"videoUrl": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"asOf": {
"type": "string"
},
"count": {
"type": "number"
},
"country": {
"type": "string"
},
"query": {
"properties": {
"keyword": {
"type": "string"
}
},
"type": "object"
},
"source": {
"properties": {
"name": {
"type": "string"
},
"via": {
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}
}
}Use it
curl
curl "https://ads.apitoll.cloud/v1/ads/facebook/search" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://ads.apitoll.cloud/v1/ads/facebook/search");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://ads.apitoll.cloud/v1/ads/facebook/search")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/4759.json, and this resource appears in /discovery/resources and /discovery/search.