Facebook Ad Library Scraper

This Actor is a powerful tool to scrape Facebook's Ad Library. It allows you to extract public ad data based on keywords, countries, and other filters. It's the perfect solution for market research, competitor analysis, and lead generation.

Key Features

• Scrapes ads from the official Facebook Ad Library.
• Filters results by keywords and countries.
• Collects all available public data, including ad text, images, and run dates.
• Extracts advertiser contact information (like email and social media) from the linked page, which is invaluable for lead generation.
• Delivers clean, structured data in formats like JSON, CSV, or Excel.

How to Use

1. Enter your search keywords (e.g., "Real Estate," "Realtor") in the keywords input field.
2. Select the countries you want to search in from a list of two-letter codes (e.g., "US", "UK", "CA").
3. Set the max_items to control the number of ads you want to scrape.
4. Decide whether you want to scrape contact information by checking the find_contact_info box.
5. Click the "Start" button.
6. Wait for the run to finish and download your data from the "Output" tab.

Input

The Actor's input is a JSON object with the following fields:

Field	Description	Type	Default	Required
keywords	A list of keywords to search for.	string[]	None	Yes
countries	A list of two-letter country codes (e.g., "US", "UK", "CA").	string[]	None	Yes
max_items	The maximum number of ads to scrape.	integer	100	No
find_contact_info	Attempt to scrape email and social media from the ad runner's website.	boolean	false	No

Output Example

The Actor outputs a dataset of ads. Each item in the dataset is a JSON object with a structure similar to this:

[
  {
    "ad_id": "1234567890123456",
    "page_name": "My Real Estate Company",
    "page_url": "[https://www.facebook.com/companypage](https://www.facebook.com/companypage)",
    "ad_text": "Looking for your dream home? Our team can help!...",
    "image_url": "[https://ad-library-image.com/123.jpg](https://ad-library-image.com/123.jpg)",
    "country": "US",
    "is_active": true,
    "run_start_date": "2024-01-15",
    "contact_info": {
      "email": "info@company.com",
      "facebook": "[https://facebook.com/company](https://facebook.com/company)",
      "linkedin": "[https://linkedin.com/company](https://linkedin.com/company)"
    }
  },
  {
    "ad_id": "9876543210987654",
    "page_name": "Another Realtor",
    "page_url": "[https://www.facebook.com/anotherrealtor](https://www.facebook.com/anotherrealtor)",
    "ad_text": "Find the perfect rental property with ease...",
    "image_url": "[https://ad-library-image.com/456.jpg](https://ad-library-image.com/456.jpg)",
    "country": "UK",
    "is_active": false,
    "run_start_date": "2023-12-20",
    "contact_info": {
      "email": null,
      "facebook": null,
      "linkedin": "[https://linkedin.com/anotherrealtor](https://linkedin.com/anotherrealtor)"
    }
  }
]