start_facebook_ads_scrape
Initiate a background Facebook Ads Library scrape to run multiple search campaigns in parallel. Returns a run_id to monitor progress and collect results.
Instructions
Start a Facebook Ads Library scrape in the background and return a run_id immediately.
Use this instead of search_facebook_ads when running multiple scrapers in parallel. Call check_run_status to monitor progress, then collect_scrape_results once SUCCEEDED.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ad_type | No | Ad type filter: ALL, POLITICAL_AND_ISSUE_ADS, HOUSING_ADS, EMPLOYMENT_ADS, or CREDIT_ADS. | ALL |
| country | No | ISO country code to filter by, e.g. 'US', 'IN', or 'ALL'. None for no filter. | |
| sort_by | No | Sort order: SORT_BY_TOTAL_IMPRESSIONS or SORT_BY_RELEVANCY_MONTHLY_GROUPED. | SORT_BY_TOTAL_IMPRESSIONS |
| end_date | No | Latest ad delivery date in YYYY-MM-DD format. None for no upper bound. | |
| media_type | No | Media type filter: ALL, IMAGE, MEME, IMAGE_AND_MEME, VIDEO, or NONE. | ALL |
| start_date | No | Earliest ad delivery date in YYYY-MM-DD format. None for no lower bound. | |
| active_status | No | Ad status filter: ALL, ACTIVE, or INACTIVE. | ALL |
| search_queries | Yes | Keywords or brand names to search for, e.g. ['nike', 'adidas']. | |
| content_languages | No | Language codes to filter ad content by, e.g. ['en', 'fr']. | |
| publisher_platforms | No | Platforms to filter by, e.g. ['facebook', 'instagram']. | |
| max_results_per_query | No | Maximum ads to return per query. Minimum 10 (actor limit). | |
| enrich_with_ad_details | No | Fetch extra per-ad details. Slower and uses more Apify credits. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | Yes | ||
| run_id | Yes | ||
| status | Yes |