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

18

Total users

0

Monthly active users

68 days

Issues response

2 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

You can test with Demo Mode first (free, no key needed) to see the output format before committing.


Quick Start

Test with Demo Mode (free, no API key needed)

{
"demoMode": true,
"searchQuery": "fitness"
}

Run with real data

{
"demoMode": false,
"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)
demoModebooleantrueNoGenerate sample data for testing (no scraping, no charges). Set to FALSE for real scraping.
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

*Required when Demo Mode is off.


Pricing

This actor uses pay-per-event billing:

EventDescriptionPrice
Ad ScrapedPer ad scraped from Meta Ad Library$0.04

Demo mode is free -- no charges for sample data.


Troubleshooting

"API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

  • Turn Demo Mode on to test with sample data
  • 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?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.


Built by John Rippy | Actor Arsenal