Facebook Ad Library Scraper – Single Ad Lookup

adId is required and accepts a numeric Library ID or supported Meta Ad Library URL. Page IDs, Facebook post IDs, and Ads Manager campaign IDs are different identifiers. One ad is looked up per run.

{
  "adId": "1191898553123641",
  "country": "ALL"
}

• The output view includes lookupStatus, status, adLibraryUrl, active, and error alongside creative fields.
• Unavailable or unknown status must stay distinct from an explicit inactive result. Missing creative fields do not by themselves establish removal.

{
  "adId": "1191898553123641",
  "libraryID": "1191898553123641",
  "brand": "Example Brand",
  "body": "Explore our new collection.",
  "linkTitle": "Shop the Collection",
  "linkUrl": "https://example.com/shop",
  "ctaText": "Shop Now",
  "ctaUrl": "https://example.com/shop",
  "images": [
    {
      "url": "https://example.com/creative.jpg"
    }
  ],
  "videos": [],
  "format": "image",
  "platforms": [
    "Facebook",
    "Instagram"
  ],
  "totalPlatforms": 2,
  "startDate": "2026-08-01T00:00:00.000Z",
  "endDate": "",
  "active": true,
  "scrapedAt": "2026-09-10T12:00:00.000Z"
}

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-library-single-ad-lookup/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.