Meta Ad Library Facebook & Instagram Ad Intelligence avatar

Meta Ad Library Facebook & Instagram Ad Intelligence

Pricing

from $0.01 / 1,000 results

Go to Apify Store
Meta Ad Library Facebook & Instagram Ad Intelligence

Meta Ad Library Facebook & Instagram Ad Intelligence

Scrape Meta's Ad Library to research Facebook and Instagram advertising strategies. Discover competitor creatives, copy & targeting insights. Ad creative extraction Copy analysis Platform targeting Demographic insights Spend estimates Status filtering Ad research Creative inspo Competitors

Pricing

from $0.01 / 1,000 results

Rating

0.0

(0)

Developer

The Howlers

The Howlers

Maintained by Community

Actor stats

0

Bookmarked

20

Total users

0

Monthly active users

6 days ago

Last modified

Share

Meta Ad Library Scraper

Scrape Facebook and Instagram Ad Library for competitor ad research. Extract ad creatives, spend estimates, and targeting data.

BYOK (Bring Your Own Key) -- you provide your own API credentials.


Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: Your Firecrawl API key from firecrawl.dev


Quick Start

Run with real data

{
"searchQuery": "fitness",
"country": "US",
"platform": "ALL",
"adType": "ALL",
"mediaType": "ALL",
"activeStatus": "ACTIVE",
"maxAds": 50,
"includeCreatives": true,
"includeEngagement": false,
"useFirecrawl": false,
"firecrawlApiKey": "YOUR_API_KEY_HERE",
"useCamoufox": false,
"enableSentimentAnalysis": false,
"aiProvider": "none",
"aiApiKey": "YOUR_API_KEY_HERE"
}

Input Parameters

ParameterTypeDefaultRequiredDescription
searchQuerystring-NoSearch for ads by keyword (e.g., 'fitness app', 'meal delivery')
pageNamestring-NoSearch for ads from a specific Facebook/Instagram page (e.g., 'Nike', 'Adidas')
pageIdstring-NoDirect Facebook Page ID (more accurate than name search)
countrystring"US"NoFilter ads by target country
platformstring"ALL"NoFilter by platform where ads run
adTypestring"ALL"NoType of ads to search for (special categories)
mediaTypestring"ALL"NoFilter by ad creative format
activeStatusstring"ACTIVE"NoFilter by ad status
maxAdsinteger50NoMaximum number of ads to scrape
includeCreativesbooleantrueNoDownload ad images and video URLs
includeEngagementbooleanfalseNoInclude detailed engagement metrics (impressions, reach, spend estimates)
useFirecrawlbooleanfalseNoUse Firecrawl API for enhanced scraping (requires API key)
firecrawlApiKeystring-Yes*Your Firecrawl API key from firecrawl.dev
useCamoufoxbooleanfalseNoUse Camoufox browser for anti-detection (helps avoid blocks)
proxyConfigurationobject-NoProxy settings for scraping
webhookUrlstring-NoURL to POST results when scraping completes (Zapier, Make, n8n)
enableSentimentAnalysisbooleanfalseNoUse AI to analyze sentiment and tone of ad copy
aiProviderstring"none"NoWhich AI provider to use for sentiment analysis
aiApiKeystring-Yes*API key for your chosen AI provider
aiModelstring-NoCustom model name (leave empty for default). Examples: gpt-4o, claude-3-5-sonnet-20241022, gemini-1.5-pro

Pricing

This actor uses pay-per-event billing:

EventDescriptionPrice
Ad ScrapedPer ad scraped from Meta Ad Library$0.04

Troubleshooting

"API key is required"

  • Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

  • Invalid input format (check the examples above)
  • API key without proper permissions
  • The target data doesn't exist or is too small to track

How do I test without an API key?


Built by John Rippy | Actor Arsenal