Meta (Facebook) Ad Library Scraper - Modern, Fast & Reliable

Provide targetUrl, searchQuery, or pageId with the appropriate country/status/media filters. maxAds controls the requested unique-ad limit. The proxy setting has its own cost and coverage implications.

{
  "searchQuery": "dinosaur",
  "country": "US",
  "activeStatus": "active",
  "maxAds": 10
}

• Rows include ad identity, advertiser, copy, CTA, media references, status, dates, platforms, and adLibraryUrl.
• Unknown status, dates, counts, and durations can be null. A carousel does not by itself establish multiple ad versions.

{
  "libraryID": "example-ad-id",
  "brand": "Example Brand",
  "pageId": "example-page-id",
  "active": null,
  "body": "Illustrative ad copy",
  "format": "image",
  "platforms": [
    "Facebook",
    "Instagram"
  ],
  "images": [
    {
      "url": "https://example.com/creative.jpg"
    }
  ],
  "videos": [],
  "adLibraryUrl": "https://www.facebook.com/ads/library/?id=example-ad-id"
}

Fields in the documented output view

Output views select columns. They do not necessarily filter record types or exhaust the full JSON payload. Use structured JSON when you need nested arrays or objects.

These are the active public event prices checked on 2026-10-29, in USD. They describe each event, not a universal flat price for a run. Confirm your current Apify plan and run budget before starting.

A result limit and a spending cap are different controls. Account charges, applicable taxes, and separately billed providers or proxies must be considered where relevant. A cap setting is not a minimum invoice charge.

Test a small run in Apify Console, inspect its records and charges, then save a task or call the actor from your own application. Keep your Apify token in an environment variable. Source-specific credentials, if required, are separate from the Apify API token.

# Save the input example as input.json and set APIFY_TOKEN.
# This request starts an asynchronous, potentially billable run.
curl --request POST \
  'https://api.apify.com/v2/acts/whoareyouanas~meta-ad-lite-scraper/runs' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data @input.json

The response identifies the run. Wait for it to finish, inspect its status, and use its default dataset and key-value store to retrieve results. A successful run can still contain partial or failed records; check the output contract above before continuing downstream.