feat: add enrichWithAdDetails option for full ad detail fetching
Add optional per-ad detail enrichment via a new enrichWithAdDetails boolean input (default: false).
New features:
- Introduce
enrichWithAdDetails input field to fetch the full ad detail page for each result
- When enabled, each ad is enriched with advertiser info, Instagram data, EU targeting breakdown, payer/beneficiary data, and violation types
- Detail fetching is skipped by default to preserve scraping speed
docs: document URLAds single ad link support and enrichWithAdDetails interaction
Updated the URLAds section in the README to reflect two additional capabilities:
- URLs with
?id= now fetch a specific ad directly without running a search query
- Pairing a
?id= URL with enrichWithAdDetails: true returns the full advertiser, targeting, and payer/beneficiary data for that single ad
fix: maxResults limit was not being respected
Fixed a bug where the maxResultsPerQuery limit was ignored in certain conditions, causing the scraper to return more results than configured.
Add support for Facebook Ads Library URLs as an alternative input mode.
New features:
- Introduce
URLAds input field allowing users to provide Ads Library URLs
- Add
maxResultsPerURL option to control results per URL
- Automatically detect URL mode vs manual search mode
The facebook-ads-url-parser actor remains unchanged and continues to call scraper-pro in standby mode.
Initial release of Facebook Ads Scraper Pro.
- Keyword search via
searchQueries
- Advertiser search via
searchAdvertisers (names or page IDs)
- Configurable filters: country, language, platform, ad status, media type, date range
- Sort by impressions or recency
- Advertiser name resolution via Facebook typeahead API
- Custom proxy support for paid users
- Session pool management with automatic rotation