Back to catalog

Apify · Search

Apify / Scrape the Meta Ad Library

Scrapes publicly running Facebook and Instagram ads for a page or an Ad Library search URL. Send startUrls; maxItems (1 to 100) and timeout (5 to 120 s) bound the run. Returns an Apify run object with status and defaultDatasetId, read the ads with apify-dataset-items.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • activeStatus body · optional

    active | inactive | empty for both

  • onlyTotal body · optional

    true returns just the ad count

  • resultsLimit body · optional

    max ads per URL

  • startUrls body · required

    Page URL or Ad Library search URL

  • maxItems query · optional

    server-side result cap; set it on every call. Example: 10

  • maxTotalChargeUsd query · optional

    Hard USD ceiling Apify enforces on this run's pay-per-event charges. Example: 0.04

  • timeout query · optional

    Seconds before Apify itself aborts the run server-side (submit-then-poll now, not bounded by the gateway's 15s outbound-fetch window). Bounded 5-300. Example: 60

Provider docs How to run it

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.

Apify / Scrape the Meta Ad Library · looot