# Changelog of Facebook Ads Library Scraper API (`api_creators/facebook-ads-library-scraper-api`) Actor

- **URL**: https://apify.com/api_creators/facebook-ads-library-scraper-api/changelog.md
- **Full Actor documentation**: https://apify.com/api_creators/facebook-ads-library-scraper-api.md

## Changelog

All notable changes to this project will be documented in this file.

### \[0.3.0] - 2026-07-30

#### 🎬 New Features

- **Skip Long Videos**: Broad searches tend to fill up with full-length TV episodes and hour-long VSLs. Set `filter_vids_longer_than_sec` and those ads are dropped before they reach your dataset — and because they don't count against your limits, the Actor keeps paginating until you have the full number of ads you asked for.

### \[0.2.0] - 2026-02-09

#### 🌍 New Features

- **See Hidden Ads**: Added a "Proxy Country" filter. Facebook hides ads if you aren't in the same country as the target audience. Now you can use our built-in residential proxies to "teleport" to any country (US, UK, DE, etc.) and see *everything* active there.

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

#### ✨ New Features

- **Facebook Ads Library Scraper**: Launch your first Actor run to collect ads from Facebook's Ads Library with ease!
- **Smart Pagination**: Automatically scrolls through endless ad results to get you all the data you need.
- **Flexible Limits**: Set custom limits per search URL or total results to control your data collection.
- **Deduplication**: No more duplicate ads — we automatically remove repeats for clean datasets.
- **Rich Ad Data**: Get complete ad details including text, images, videos, targeting info, and performance metrics.
- **Multiple Searches**: Run multiple ad library searches in one go for comprehensive research.
- **Easy Configuration**: Simple input options with clear validation and helpful defaults.
- **Export Ready**: Structured data perfect for analysis, dashboards, or exporting to CSV/Excel.

#### 🔒 Security & Reliability

- Passed security scans with flying colors
- Secure logging practices to protect your data
- No sensitive information stored or exposed