# Changelog of Facebook Ads Scraper Pro (`dz_omar/facebook-ads-scraper-pro`) Actor

- **URL**: https://apify.com/dz\_omar/facebook-ads-scraper-pro/changelog.md
- **Full Actor documentation**: https://apify.com/dz\_omar/facebook-ads-scraper-pro.md

## Changelog

### \[0.1.0] - 2026-07-01

- Added a new charge event for fetching enriched ad details.
- Fixed a bug in the language filter input.
- General reliability and stability improvements.

### \[0.0.14] - 2026-03-19

#### 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.

### \[0.0.6] - 2026-03-12

#### feat: add URLAds input mode with inline URL parsing support

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.

### \[0.0.1] - 2025-01

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