GET
$0.03 default
/v1/ads/facebook/searchDescription
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.
Pricing
$0.03 default
Parameters
{
"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"
}Example response
{
"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"
}
}