Meta Ads Library Scraper

Extract public Meta Ad Library ads without requiring a Meta API token. The actor searches the public Meta Ad Library for brands, page names, domains, or keywords, then returns structured ad rows with page names, ad archive IDs, active status, dates, creative text, landing pages, image URLs, video URLs, platforms, and direct ad detail links.

Use it when you want a low-friction Meta ads export for competitor monitoring, creative research, agency reporting, or cross-platform ad intelligence workflows.

Why use Meta Ads Library Scraper?

• Search Meta Ad Library without asking users for a Meta developer token.
• Export creative text, headlines, descriptions, CTA text, landing pages, images, videos, and advertiser page details.
• Monitor active and inactive ads by brand or keyword.
• Build creative swipe files from public Facebook and Instagram ad records.
• Combine Meta rows with Google, TikTok, Bing, and LinkedIn ad datasets.

What data does Meta Ads Library Scraper extract?

Field group	Fields
Search context	target, country, runId
Advertiser identity	pageName, pageId, pageProfileUrl, pageProfilePictureUrl
Creative identity	adArchiveId, adId, adDetailsUrl, isActive
Timing	startDate, endDate
Copy and links	headline, description, caption, callToAction, creativeBody, creativeText, landingPageUrl, landingPageUrls
Assets	imageUrl, imageUrls, videoUrl, videoUrls, displayFormat
Delivery context	publisherPlatforms, impressionsText, reachEstimate, categories, collationCount

The actor uses public Meta Ad Library pages and browser rendering. It does not require a Facebook login or Meta API access token for the tested public search path.

What input does Meta Ads Library Scraper accept?

{
  "targets": ["Nike"],
  "country": "US",
  "maxAds": 25,
  "activeStatus": "ALL"
}

Input	Required	Description
targets	Yes	Brand names, page names, domains, or keywords. Examples: Nike, nike.com, Shopify.
country	Yes	ISO country code used by Meta Ad Library. Examples: US, GB, DE, FR, PT. Default: US.
maxAds	No	Maximum ad records to return per target. Default: 25; maximum: 250.
activeStatus	No	ALL, ACTIVE, or INACTIVE. Default: ALL.
shownSince	No	Keep ads whose end date or start date is on or after this YYYY-MM-DD date.
datasetId	No	Existing Apify dataset ID for pipeline runs. Rows are appended there in addition to the default run dataset.
runId	No	External workflow ID copied to output rows and RUN_SUMMARY.

What output does Meta Ads Library Scraper return?

Example row:

{
  "target": "Nike",
  "country": "US",
  "pageName": "Nike",
  "pageId": "15087023444",
  "adArchiveId": "1869276447125570",
  "isActive": true,
  "startDate": "2026-07-10",
  "headline": "Nike",
  "description": "Shop new releases",
  "creativeText": "Nike | Shop new releases",
  "landingPageUrl": "https://www.nike.com/",
  "imageUrl": "https://scontent.xx.fbcdn.net/...",
  "publisherPlatforms": ["FACEBOOK", "INSTAGRAM"],
  "adDetailsUrl": "https://www.facebook.com/ads/library/?id=1869276447125570"
}

Some ads are carousel or video creatives. Those rows can include multiple imageUrls, videoUrls, and landingPageUrls. Meta does not expose headline or description for every public ad record; when those fields are absent, use creativeBody, caption, callToAction, and creativeText for the available copy.

How do I run Meta Ads Library Scraper?

1. Add one or more brands, page names, domains, or keywords.
2. Choose a country and active status.
3. Set maxAds based on how deep you want the run to go.
4. Run the actor and download the dataset as JSON, CSV, Excel, or through the Apify API.

How can I use Meta Ads Library Scraper through the API?

curl "https://api.apify.com/v2/acts/YOUR_USERNAME~meta-ads-library-scraper/runs" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -d '{
    "targets": ["Nike"],
    "country": "US",
    "maxAds": 25
  }'

Fetch dataset items:

curl "https://api.apify.com/v2/datasets/DATASET_ID/items?clean=true" \
  -H "Authorization: Bearer $APIFY_TOKEN"

How can I monitor advertisers over time?

Schedule the actor daily or weekly with the same targets and country. Use adArchiveId, pageId, startDate, endDate, and creativeText to deduplicate ads and detect new creative angles.

What are the limits of Meta Ads Library Scraper?

• Public keyword searches can return ads that mention the target, not only ads owned by that brand.
• Browser rendering is slower and more expensive than the official Graph API path.
• Headline and description are returned only when Meta exposes title or link description fields in the public payload.
• Spend, impressions, and targeting fields are only returned when visible in the public page payload.
• Meta can change page structure, public payloads, or anti-bot behavior.
• The actor records recoverable extraction issues in RUN_SUMMARY rather than inventing rows.

How do I troubleshoot Meta Ads Library Scraper?

Issue	Likely cause	Solution
No rows were returned	No public ads matched the target/country/status, or Meta changed the public page payload	Try a broader target, another country, or check RUN_SUMMARY.
Results include unrelated advertisers	Keyword search matches text and mentions	Use a more specific brand, domain, or page name.
Some rows have no images or videos	The public record is text-only or Meta withheld the asset in the page payload	Use creative text, landing page, and ad detail URL fields.
Runs are slower than API-based actors	The actor uses a browser to access the public page	Lower maxAds for quick checks or split large target lists.

What changed in the current version?

0.1

• Initial public Meta Ad Library scraper with no Meta API token required, browser rendering, creative text extraction, landing pages, images, videos, dates, platforms, and direct ad links.