Facebook Ads Scraper icon

Facebook Ads Scraper

Extract ads from Facebook Ad Library for competitive intelligence and market research. By John Rippy.

Facebook Ads Scraper

AI-generated

Summary

Searches Facebook Ad Library through an Apify actor for a term or advertiser, using the selected country, ad type, result limit, demo setting, and timeout. On success, returns the run ID, status, ad count, and ads; on an unsuccessful run, returns the run ID, status, and a message.

Inputs

  • Search Query (required) — Search term or advertiser name to look up.
  • Country — Country to search: United States (default), United Kingdom, Canada, Australia, Germany, France, or All Countries.
  • Max Results — Maximum number of ads to retrieve (default 50).
  • Ad Type — Filter for all ads (default), political ads, or non-political ads.
  • Demo Mode — Enable sample data for testing (default false).
  • Timeout (seconds) — How long to wait for the Apify run to finish (default 180 seconds).

Output shape

One item per input item, each containing a JSON object.

For a SUCCEEDED run, the object contains runId, status, adCount, and ads. For any other run status, it contains runId, status, and a message. Requires Apify API credentials with an apiToken; API errors are raised as node operation errors.

Links

Discussion