Pricing

Rating

Developer

Actor stats

Categories

Share

Facebook Ads Library Scraper

Scrape active Facebook ads with filters like keywords, dates, media type, and country

Overview

This actor scrapes Facebook's Ads Library to extract detailed information about active advertising campaigns. Ideal for marketers, competitors, and researchers analyzing ad strategies. Supports filtering by:

• Keywords/phrases (e.g., "free shipping")
• Date ranges (up to 2025-02-15)
• Media types (video/image/text)
• Countries (e.g., GB for UK-targeted ads)
• Ad status (active/inactive)

Features

• 🔎 Keyword Search (no URL needed): Just enter search terms, countries, and status — the actor builds the Meta Ad Library query for you. No hand-crafted URLs.
• Flexible URL Input: Supports both Ads Library URLs and direct Facebook page URLs (e.g., https://www.facebook.com/SHEINOFFICIAL)
• Automatic Page ID Extraction: Automatically extracts page IDs from Facebook page URLs and converts them to Ads Library format
• Precision Filtering: Target ads by 10+ criteria including media type, country, and exact keywords
• Dynamic Delays: Randomized delays (5-10s) between API calls to avoid detection
• Residential Proxies: Built-in Apify residential proxy rotation
• Retry Resilience: 100 retries per failed request
• Concurrency Control: Process 1-10 pages simultaneously
• Historical Range: Scrape ads up to future dates (2025-02-15 supported)

How to Use

1. Configure Input: Set your filters in the input JSON (see configuration below)
2. Run via Apify: Execute the actor on Apify platform
3. Export Data: Download results as JSON, CSV, or Excel
4. Analyze: Track ad creatives, sponsors, and run dates

Input Configuration

Easiest — Search by keyword (no URL needed)

Just type what you want and the actor builds the Meta Ad Library query for you — no need to hand-craft a URL.

{
"searchTerms":["nike","weight loss"],
"searchCountries":["US","GB"],
"adActiveStatus":"active",
"mediaType":"all",
"searchMode":"keyword_unordered",
"maxItems":100,
"proxy":{"useApifyProxy":true,"apifyProxyGroups":["RESIDENTIAL"]}
}

Need political/housing/employment ad categories, a specific publisher platform, or a content language? Paste a full Ads Library URL via startUrls instead (see the advanced examples below).

Example 1: Using Facebook Page URLs (Direct)

{
"startUrls":[
"https://www.facebook.com/SHEINOFFICIAL",
"https://www.facebook.com/Nike",
"https://www.facebook.com/usemotionapp"
],
"maxItems":100,
"minDelay":5,
"maxDelay":10,
"proxy":{
"useApifyProxy":true,
"apifyProxyGroups":["RESIDENTIAL"]
}
}

Example 2: Using Ads Library URLs (Advanced Filtering)

{
"startUrls":[
"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=GB&is_targeted_country=false&media_type=video&q=%22free%20shipping%22&search_type=keyword_exact_phrase&start_date[min]&start_date[max]=2025-02-15",
"https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&view_all_page_id=103598131567301"
],
"maxItems":100,
"minDelay":5,
"maxDelay":10,
"maxConcurrency":10,
"minConcurrency":1,
"maxRequestRetries":100,
"proxy":{
"useApifyProxy":true,
"apifyProxyGroups":["RESIDENTIAL"]
}
}

Supported URL Formats

The scraper accepts two types of URLs:

1. Direct Facebook Page URLs

https://www.facebook.com/SHEINOFFICIAL
https://www.facebook.com/Nike
https://www.facebook.com/usemotionapp

How it works:

• The scraper automatically fetches the page with authentication
• Extracts the page ID (e.g., 100064280965738 for SHEIN)
• Converts to Ads Library URL format
• Fetches all ads for that page

2. Facebook Ads Library URLs (with filters)

https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=GB&media_type=video&q=keyword
https://www.facebook.com/ads/library/?active_status=all&search_type=page&view_all_page_id=123456

Benefits:

• Apply advanced filters (country, media type, keywords, date ranges)
• Search by page ID directly
• Filter by active/inactive status

Input Parameters

Output Structure

{
"FB AD Link":"https://www.facebook.com/ads/library/?id=554396010944539",
"FB Link":"https://www.facebook.com/usemotionapp/",
"Company Name":"Motion",
"Website":"usemotion.com",
"ad_archive_id":"554396010944539",
"ad_id":null,
"archive_types":[],
"categories":[
"UNKNOWN"
],
"collation_count":3,
"collation_id":"693850463625155",
"contains_digital_created_media":false,
"contains_sensitive_content":false,
"currency":"",
"end_date":1750921200,
"entity_type":"PERSON_PROFILE",
"fev_info":null,
"finserv_ad_data":null,
"gated_type":"ELIGIBLE",
"has_user_reported":false,
"hidden_safety_data":false,
"hide_data_status":"NONE",
"impressions_with_index":{
"impressions_text":null,
"impressions_index":-1
},
"is_aaa_eligible":true,
"is_active":true,
"is_profile_page":false,
"menu_items":[],
"page_id":"103598131567301",
"page_is_deleted":false,
"page_name":"Motion",
"political_countries":[],
"publisher_platform":[
"FACEBOOK",
"INSTAGRAM"
],
"reach_estimate":null,
"regional_regulation_data":{
"finserv":{
"is_deemed_finserv":false,
"is_limited_delivery":false
},
"tw_anti_scam":{
"is_limited_delivery":false
}
},
"report_count":null,
"snapshot":{
"body":{
"text":"Be 137% more productive."
},
"branded_content":null,
"brazil_tax_id":null,
"byline":null,
"caption":"usemotion.com",
"cards":[],
"cta_text":"Saznajte više",
"cta_type":"LEARN_MORE",
"country_iso_code":null,
"current_page_name":"Motion",
"disclaimer_label":null,
"display_format":"IMAGE",
"event":null,
"images":[
{
"original_image_url":"https://scontent.fhan3-3.fna.fbcdn.net/v/t39.35426-6/502492793_1054293803317783_201280583862847808_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=79MpJoaVUG4Q7kNvwGzgwMb&_nc_oc=AdmiCbM4h7hHcjzS78hBXhh-kqbqOiyZbu5YcnjTmYi8fJyxiRCghxaZKOkyGakvKAg&_nc_zt=14&_nc_ht=scontent.fhan3-3.fna&_nc_gid=NsTWAzJgoGosAcGMska1iA&oh=00_AfOBxg0zBZE5I8h5tQ7QlqjO3BHFUqgBjNGOIwlhhhXnmQ&oe=6863D5BA",
"resized_image_url":"https://scontent.fhan3-3.fna.fbcdn.net/v/t39.35426-6/502652905_549954111382058_5494539714617214349_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=11YsJKhHL9gQ7kNvwFQyF27&_nc_oc=AdmwIyTGYmabIQ3WHIslhtAT6bmK-pIkXvG6fem73EUvNaeqpRlhhRrs6w-ml-ufqI8&_nc_zt=14&_nc_ht=scontent.fhan3-3.fna&_nc_gid=NsTWAzJgoGosAcGMska1iA&oh=00_AfN41oyHr6YPW3Oq9j2P4jT45pOn01uFJHcFHeXyg51a7A&oe=6863D380",
"watermarked_resized_image_url":"",
"image_crops":[]
}
],
"is_reshared":false,
"link_description":"Motion Teams | Automatically prioritize tasks, schedule meetings, and resolve calendar conflicts. Used by over 10k CEOs and professionals to improve focus, get more done, and streamline workday.",
"link_url":"https://www.usemotion.com/teams",
"page_categories":[
"Software"
],
"page_entity_type":"PERSON_PROFILE",
"page_id":"103598131567301",
"page_is_deleted":false,
"page_is_profile_page":false,
"page_like_count":41998,
"page_name":"Motion",
"page_profile_picture_url":"https://scontent.fhan4-5.fna.fbcdn.net/v/t39.35426-6/508816737_586512144117458_1442892662474165395_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=pC-2Jifxs-kQ7kNvwHYxKPV&_nc_oc=AdlONKKEnKB8H5DdW-UAjQiF6v_oiF5LX2Nu7VArJ_JATWPzqPzqwORlya5VUYCpafM&_nc_zt=14&_nc_ht=scontent.fhan4-5.fna&_nc_gid=NsTWAzJgoGosAcGMska1iA&oh=00_AfPizUrkt_Gl03E8xTDQCz3GBlbeCfXWC_Mkr_YRLNHjBQ&oe=6863E1F2",
"page_profile_uri":"https://www.facebook.com/usemotionapp/",
"root_reshared_post":null,
"title":"AI Project Management",
"videos":[],
"additional_info":null,
"ec_certificates":[],
"extra_images":[],
"extra_links":[],
"extra_texts":[],
"extra_videos":[]
},
"spend":null,
"start_date":1750921200,
"state_media_run_label":null,
"targeted_or_reached_countries":[],
"total_active_time":71587,
"data_reach":{
"advertiser":{
"page":{
"about":{
"text":"Motion increases productivity by 137%\n\nWith automation and AI that intelligently plan your day, sched"
},
"is_delegate_page_with_linked_primary_profile":false,
"id":"103598131567301"
},
"ad_library_page_info":null
},
"aaa_info":{
"targets_eu":true,
"location_audience":[
{
"name":"Nizozemska",
"num_obfuscated":0,
"type":"countries",
"excluded":false
},
{
"name":"Njemačka",
"num_obfuscated":0,
"type":"countries",
"excluded":false
}
],
"gender_audience":"Svi",
"age_audience":{
"min":18,
"max":65
},
"eu_total_reach":16,
"age_country_gender_reach_breakdown":[
{
"country":"NL",
"age_gender_breakdowns":[
{
"age_range":"35-44",
"male":1,
"female":1,
"unknown":null
},
{
"age_range":"55-64",
"male":1,
"female":null,
"unknown":null
},
{
"age_range":"18-24",
"male":1,
"female":null,
"unknown":null
},
{
"age_range":"25-34",
"male":1,
"female":1,
"unknown":null
}
]
},
{
"country":"DE",
"age_gender_breakdowns":[
{
"age_range":"55-64",
"male":2,
"female":null,
"unknown":null
},
{
"age_range":"18-24",
"male":1,
"female":3,
"unknown":null
},
{
"age_range":"35-44",
"male":null,
"female":4,
"unknown":null
}
]
}
],
"payer_beneficiary_data":[
{
"payer":"Motion",
"beneficiary":"Motion"
}
],
"has_violating_payer_beneficiary":false,
"is_ad_taken_down":false
},
"violation_types":[],
"verified_voice_context":null,
"transparency_by_location":null
}
}

Basic Ad Information

Ad Identification

Ad Status & Timing

Ad Content & Format

Page/Advertiser Insights

Technical Metadata

Compliance & Regulations

User Interaction Data

Monetization & Reach

System Flags

Audience & Targeting

Key Notes

1. Timestamps: Convert Unix timestamps (e.g., 1750921200 → 2025-02-24T23:00:00Z)
2. Null Fields: Indicate restricted data per Facebook's policies
3. Media URLs: May expire - download promptly
4. Audience Data: Includes detailed demographic breakdowns when available
5. Compliance: Contains regulatory information for different regions

Key fields include:

• Ad creative (text/images/video URLs)
• Sponsor page details and metrics
• Detailed audience targeting information
• Active dates and duration
• Compliance and regulation data
• Call-to-action configuration

Why This Scraper?

• Compliance: Follows Facebook's rate limits and robots.txt
• Stealth: Residential proxies + random delays mimic human behavior
• Depth: Captures 30+ data points per ad including edits history
• Future-Proof: Handles Facebook's frequent UI/API changes

Use Cases

• Track competitor ad strategies in real-time
• Analyze seasonal campaign patterns
• Archive political ads for transparency
• Monitor trademark violations

Explore More Scrapers

If you found this Apify Smartbuyglasses Scraper useful, be sure to check out our other powerful scrapers and actors at memo23's Apify profile. We offer a wide range of tools to enhance your web scraping and automation needs across various platforms and use cases.

Support

• For issues or feature requests, please use the Issues section of this actor.
• If you need customization or have questions, feel free to contact the author:
  • Author's website: https://muhamed-didovic.github.io/
  • Email: muhamed.didovic@gmail.com

Additional Services

• Request customization or whole dataset: muhamed.didovic@gmail.com
• If you need anything else scraped, or this actor customized, email: muhamed.didovic@gmail.com
• For API services of this scraper (no Apify fee, just usage fee for the API), contact: muhamed.didovic@gmail.com
• Email: muhamed.didovic@gmail.com