Meta Ad Library Facebook & Instagram Ad Intelligence
Pricing
from $0.01 / 1,000 results
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
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
| Parameter | Type | Default | Required | Description |
|---|---|---|---|---|
searchQuery | string | - | No | Search for ads by keyword (e.g., 'fitness app', 'meal delivery') |
pageName | string | - | No | Search for ads from a specific Facebook/Instagram page (e.g., 'Nike', 'Adidas') |
pageId | string | - | No | Direct Facebook Page ID (more accurate than name search) |
country | string | "US" | No | Filter ads by target country |
platform | string | "ALL" | No | Filter by platform where ads run |
adType | string | "ALL" | No | Type of ads to search for (special categories) |
mediaType | string | "ALL" | No | Filter by ad creative format |
activeStatus | string | "ACTIVE" | No | Filter by ad status |
maxAds | integer | 50 | No | Maximum number of ads to scrape |
includeCreatives | boolean | true | No | Download ad images and video URLs |
includeEngagement | boolean | false | No | Include detailed engagement metrics (impressions, reach, spend estimates) |
demoMode | boolean | true | No | Generate sample data for testing (no scraping, no charges). Set to FALSE for real scraping. |
useFirecrawl | boolean | false | No | Use Firecrawl API for enhanced scraping (requires API key) |
firecrawlApiKey | string | - | Yes* | Your Firecrawl API key from firecrawl.dev |
useCamoufox | boolean | false | No | Use Camoufox browser for anti-detection (helps avoid blocks) |
proxyConfiguration | object | - | No | Proxy settings for scraping |
webhookUrl | string | - | No | URL to POST results when scraping completes (Zapier, Make, n8n) |
enableSentimentAnalysis | boolean | false | No | Use AI to analyze sentiment and tone of ad copy |
aiProvider | string | "none" | No | Which AI provider to use for sentiment analysis |
aiApiKey | string | - | Yes* | API key for your chosen AI provider |
aiModel | string | - | No | Custom 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:
| Event | Description | Price |
|---|---|---|
| Ad Scraped | Per 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