Facebook Ad Library Scraper ## Overview The Facebook Ad Library Scraper is a powerful tool designed to extract ad data from the Facebook Ad Library. Whether you are a marketer, researcher, or business owner, this actor helps you gain insights into advertising strategies, creative trends, and competitor campaigns. It provides a reliable way to access public ad data for analysis and inspiration. ## Features - Comprehensive Ad Extraction: Retrieve ads from any Facebook page or keyword search. - Flexible Filtering: Filter ads by active status, category (political, housing, employment, credit), and country. - Detailed Data: Get rich data including ad copy, creative details, start dates, and more. - Easy to Use: Supports both direct Ad Library URLs and Facebook Page URLs. ## How to Use You can use this scraper in two ways: ### Method 1: Using a Facebook Page URL If you want to scrape ads for a specific advertiser: 1. Enter the Facebook Page URL (e.g., https://www.facebook.com/Google/) into the Target URL field. 2. Configure the filters using the input fields: - Active Status: Choose between All, Active, or Inactive ads. - Ad Category: Select a specific category like Housing, Employment, or All. - Country: Specify the country to filter ads by (e.g., US, GB, BR). ### Method 2: Using a Direct Ad Library Link If you prefer to set up your search directly on Facebook: 1. Go to the Facebook Ad Library. 2. Perform your search and apply any desired filters (country, category, keywords). 3. Copy the URL from your browser's address bar. 4. Paste it into the Target URL field in the actor input. - Note: When using this method, the actor will prioritize the filters in the URL over the input parameters. ## Input Parameters | Parameter | Type | Description | | :---------------- | :----- | :------------------------------------------------------------------ | | Target URL | String | The Facebook Page URL or the direct Facebook Ad Library search URL. | | Max Results | Number | The maximum number of ads to scrape. | | Active Status | Select | Filter for Active, Inactive, or All ads. | | Ad Category | Select | Filter by category (e.g., Political, Housing, Employment). | | Country | Select | Filter ads by specific country code (e.g., US, CA, ALL). | ## Output The scraper stores the results in a dataset, which can be downloaded in various formats (JSON, CSV, Excel, etc.). Each item represents an ad and contains details such as: - Ad ID - Ad Creative (Images/Videos) - Ad Copy (Text) - Start Date - Publisher Platforms - And more...