Facebook Ads Library Scraper

📢 What is Facebook Ads Library Scraper?

Facebook Ads Library Scraper extracts publicly available ads from Facebook Ads Library using search URLs generated from Facebook Ads Library. Collect structured advertising data for keyword or advertiser searches with configurable scraping options and optional ad detail extraction.

For large historical searches, the actor automatically partitions date ranges into monthly requests to improve data coverage and collect more complete historical datasets—all handled transparently in a single run.

It's designed for marketers, researchers, agencies, journalists, compliance teams, and anyone looking to analyze or monitor advertising activity at scale.

Simply configure your search on Facebook Ads Library with the filters you need, paste the generated search URL, click Save & Start, and start collecting structured advertising datasets.

---

⭐ Why Use This Actor?

• 📅 Smart Date Range Partitioning: Automatically partitions long date ranges into monthly requests, helping collect more complete historical datasets.

• 📋 Optional Extra Ad Details: Enrich your datasets with additional ad details such as estimated reach, spend, demographic distribution, and other publicly available metadata when available.

• ⚡ Fast API-Based Extraction: Collect Facebook Ads Library data through direct API requests instead of browser automation, making scraping faster, more reliable, and resource-efficient.

• 🛡️ Reliable Session Management: Built-in session handling, retries, and recovery mechanisms help keep long-running scraping jobs stable and resilient.

• 🔄 Apify Resurrect Run Support: Long-running scraping jobs can automatically resume from the last saved progress after an interruption instead of starting over.

• 💰 Affordable Pricing: Scrape Facebook Ads Library data for just $0.60 per 1,000 ads, making it a cost-effective solution for both small and large-scale data collection.

---

📊 What Data Can You Extract?

The actor returns one dataset item per ad.

Basic Ad Data

Category	Included Data
📢 Ad Information	Ad Archive ID, ad status, delivery dates, display format, ad title, ad text, caption, CTA text, CTA type, disclaimers, and reshared content information
🏢 Advertiser Information	Page ID, page name, profile URL, profile picture, page categories, page likes, and page status
🖼️ Creative Assets	Images, videos, carousel cards, thumbnails, media URLs, extra images, extra videos, and creative metadata
🔗 Landing Pages & Links	Landing page URLs, captions, bylines, link descriptions, destination URLs, and additional links
🌍 Delivery Information	Publisher platforms, targeted countries, regional regulation data, content flags, and other delivery metadata

⭐ Ad Details (Optional)

Enable Include Ad Details to enrich each ad with the following additional information when available.

Category	Included Data
👤 Advertiser Profile	Advertiser About, Instagram username, followers, verification, page alias, category, cover photo, profile photo, page verification, and profile type
📊 Transparency & Audience	Reach insights, audience demographics, transparency by location, age, gender, country breakdowns, and regional transparency information
⚖️ Compliance & Page Insights	Page spend, political advertiser indicators, restriction status, verified voice context, violation types, AI disclosure eligibility, and other compliance metadata

🚀 How to Scrape Facebook Ads Library

Scrape Ads from an Advertiser

The simplest way to scrape ads from a Facebook page is to copy the advertiser's Ads Library URL and provide it as input.

{
  "urls": [
    "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=IN&is_targeted_country=false&media_type=all&search_type=page&sort_data[direction]=desc&sort_data[mode]=total_impressions&view_all_page_id=15087023444"
  ]
}

Scrape Ads with Additional Details

Enable Include Extra Ad Details to enrich each ad with additional advertiser information, reach, spend, and transparency data when available. Since this performs one additional request per ad, runs may take slightly longer to complete.

{
  "resultsPerUrl": 100,
  "includeAdDetails": true,
  "urls": [
    "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=IN&is_targeted_country=false&media_type=all&search_type=page&sort_data[direction]=desc&sort_data[mode]=total_impressions&view_all_page_id=15087023444"
  ]
}

Scrape Ads Within a Date Range

Apply filters and sorting either while generating the Ads Library URL or later using the actor's input options.

{
  "impressionsFrom": "2025-01-01",
  "impressionsTo": "2025-06-30",
  "urls": [
    "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=IN&is_targeted_country=false&media_type=all&search_type=page&sort_data[direction]=desc&sort_data[mode]=total_impressions&view_all_page_id=15087023444"
  ]
}

---

📥 Sample Output

Basic Output

{
    "ad_archive_id": "1565227778300572",
    "ad_id": null,
    "collation_id": null,
    "collation_count": null,
    "is_active": true,
    "start_date": 1780642800,
    "end_date": 1782716400,
    "page_id": "15087023444",
    "page_name": "Nike",
    "page_profile_uri": "https://facebook.com/nike",
    "page_profile_picture_url": "https://scontent-lax3-1.xx.fbcdn.net/v/t39.35426-6/714759574_978804974955243_8724360225588544713_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=pqvbGWkpGtgQ7kNvwHKdevF&_nc_oc=AdofmwD-IPk5QFvEfzWdSY6ybB7zZzayohGIovFaK928wtGJPqggz6txEFhfK2DKeaU&_nc_zt=14&_nc_ht=scontent-lax3-1.xx&_nc_gid=OpbV7PdDiOM8f0ubH0gaFQ&_nc_ss=79180&oh=00_AQDnMfwOcqQ14LnURL7oNRSO8DyzaKZ5huP3LACxkftWeg&oe=6A49568D",
    "page_categories": [
      "Sportswear"
    ],
    "page_like_count": 39602147,
    "page_is_deleted": false,
    "title": "{{product.name}}",
    "ad_text": "Free delivery, easy returns and the widest range of Nike® innovation.",
    "caption": "nike.in",
    "cta_text": "Shop now",
    "cta_type": "SHOP_NOW",
    "cards": [
      {
        "body": "Free delivery, easy returns and the widest range of Nike® innovation.",
        "cta_type": "SHOP_NOW",
        "caption": "nike.in",
        "link_description": "Nike - Official Online Store for Athletic Shoes, Clothing & Sports Gear. Shop the latest Nike products and enjoy free shipping.",
        "link_url": "https://www.nike.in/nike-as-u-nsw-tee-lse-prem-ess-wash/p/24928094",
        "title": "AS U NSW TEE LSE PREM ESS WASH",
        "cta_text": "Shop Now",
        "video_hd_url": null,
        "video_preview_image_url": null,
        "video_sd_url": null,
        "watermarked_video_hd_url": null,
        "watermarked_video_sd_url": null,
        "image_crops": [],
        "original_image_url": "https://scontent-lax3-2.xx.fbcdn.net/v/t39.35426-6/716922492_1023869790177871_6994111317368725597_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=wTkyDJa471sQ7kNvwFyhK38&_nc_oc=Adpb67ItXgppE5wSendjVTMGnIGGS_qBKqUvjNqANDexVyjy4EIa3K2JwdpYWo0Hpms&_nc_zt=14&_nc_ht=scontent-lax3-2.xx&_nc_gid=OpbV7PdDiOM8f0ubH0gaFQ&_nc_ss=79180&oh=00_AQBiIgNqT19YL-vDFPu-k9gg3PTInmSA87CXnHoTVFq62w&oe=6A494790",
        "resized_image_url": "https://scontent-lax3-2.xx.fbcdn.net/v/t39.35426-6/716922492_1023869790177871_6994111317368725597_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=wTkyDJa471sQ7kNvwFyhK38&_nc_oc=Adpb67ItXgppE5wSendjVTMGnIGGS_qBKqUvjNqANDexVyjy4EIa3K2JwdpYWo0Hpms&_nc_zt=14&_nc_ht=scontent-lax3-2.xx&_nc_gid=OpbV7PdDiOM8f0ubH0gaFQ&_nc_ss=79180&oh=00_AQCfBN4NdW96F6Pqzh3-wuwQA0EGONO1xEzKD7ipQWXMyw&oe=6A494790",
        "watermarked_resized_image_url": ""
      }
    
    ],
    "extra_links": [],
    "extra_texts": [],
    "extra_images": [],
    "extra_videos": [],
    "disclaimer_label": null,
    "country_iso_code": null,
    "byline": null,
    "root_reshared_post": null,
    "is_reshared": false,
    "display_format": "DPA",
    "link_url": "http://www.nike.in/",
    "link_description": null,
    "images": [],
    "videos": [],
    "publisher_platform": [
      "FACEBOOK",
      "INSTAGRAM",
      "THREADS"
    ],
    "targeted_or_reached_countries": [],
    "reach_estimate": null,
    "currency": "",
    "spend": null,
    "contains_sensitive_content": false,
    "gated_type": "ELIGIBLE",
    "contains_digital_created_media": false,
    "hide_data_status": "NONE",
    "regional_regulation_data": {
      "finserv": {
        "is_deemed_finserv": false,
        "is_limited_delivery": false
      },
      "tw_anti_scam": {
        "is_limited_delivery": false
      }
    }
   
  }

Output with Ad Details

{
    "ad_archive_id": "2146111439489893",
    "ad_id": null,
    "collation_id": "1193720922378650",
    "collation_count": 8,
    "is_active": false,
    "start_date": 1774508400,
    "end_date": 1781161200,
    "page_id": "129669023798560",
    "page_name": "Gymshark",
    "page_profile_uri": "https://facebook.com/Gymshark",
    "page_profile_picture_url": "https://scontent-lga3-2.xx.fbcdn.net/v/t39.35426-6/656126655_2414253592350694_7696471576237674723_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=qLErWZd4aNQQ7kNvwHWHky3&_nc_oc=AdqR6Kgv8d4UWtm7a7sI4_KGQI-jXKODnHEmlJo3xzskxLKaRAvp1f7WZq8tMDaDjhc&_nc_zt=14&_nc_ht=scontent-lga3-2.xx&_nc_gid=7UVx8OwJy7R97XEmsHg4xQ&_nc_ss=79180&oh=00_AQCk9jYFkEWy2f3ZIV3fALb5LieHGMapPibIJYZ6ZM-9RA&oe=6A49E125",
    "page_categories": [
      "Clothing (Brand)"
    ],
    "page_like_count": 2189525,
    "page_is_deleted": false,
    "title": null,
    "ad_text": "{{product.brand}}",
    "caption": "de.gymshark.com",
    "cta_text": "Shop now",
    "cta_type": "SHOP_NOW",
    "cards": [
      {
        "body": "Häng dich rein und mach 2026 zu deinem ✨besten✨ Jahr 🔥\n\nSpare mit dem Code WELCOME10 10 % extra auf deine erste Bestellung.",
        "cta_type": "SHOP_NOW",
        "caption": "",
        "link_description": "Entdecke unsere Kollektion mit den Must-Haves für Damen jetzt und bringe deine Fitness Reise auf das nächste Level. Shoppe jetzt.",
        "link_url": "https://de.gymshark.com/collections/must-have/womens",
        "title": "Gymshark. We Do Gym.",
        "cta_text": "Shop Now",
        "video_hd_url": null,
        "video_preview_image_url": null,
        "video_sd_url": null,
        "watermarked_video_hd_url": null,
        "watermarked_video_sd_url": null,
        "image_crops": [],
        "original_image_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.35426-6/656389226_1372751888221065_6699105897432097880_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Vx87ZmKYqtMQ7kNvwFHW0de&_nc_oc=AdoxMLwgnEmoKx25jrbh2QIjb6PEkiFU_k3_3pj757dF_PVjm4j8HRZb7kjPlyXVjg0&_nc_zt=14&_nc_ht=scontent-lga3-3.xx&_nc_gid=7UVx8OwJy7R97XEmsHg4xQ&_nc_ss=79180&oh=00_AQD6RFrNvlGli1qFpWRDaCp82ASfaQaYUyymWTjHhU9ixQ&oe=6A49C154",
        "resized_image_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.35426-6/655722698_1457132209496623_5905703204039821190_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=nYnEx0twLsYQ7kNvwGZxox2&_nc_oc=AdrFGED2gcgtiQ8jozy_XrHjUi8ZS2pkHBnEQRfUHbsizeZp-gsVBek4Tnyy6of0Kpg&_nc_zt=14&_nc_ht=scontent-lga3-3.xx&_nc_gid=7UVx8OwJy7R97XEmsHg4xQ&_nc_ss=79180&oh=00_AQAHXvSiDimMhwBPHpVFI4iPyNg7DNMLJhnsftsrwn2NDg&oe=6A49EB83",
        "watermarked_resized_image_url": ""
      }
    
    ],
    "extra_links": [],
    "extra_texts": [],
    "extra_images": [],
    "extra_videos": [],
    "disclaimer_label": null,
    "country_iso_code": null,
    "byline": null,
    "root_reshared_post": null,
    "is_reshared": false,
    "display_format": "DCO",
    "link_url": "https://de.gymshark.com/collections/must-have/womens",
    "link_description": null,
    "images": [],
    "videos": [],
    "publisher_platform": [
      "INSTAGRAM"
    ],
    "targeted_or_reached_countries": [],
    "reach_estimate": null,
    "currency": "",
    "spend": null,
    "contains_sensitive_content": false,
    "gated_type": "ELIGIBLE",
    "contains_digital_created_media": false,
    "hide_data_status": "NONE",
    "regional_regulation_data": {
      "finserv": {
        "is_deemed_finserv": false,
        "is_limited_delivery": false
      },
      "tw_anti_scam": {
        "is_limited_delivery": false
      }
    },
    "total_active_time": null,
    "impressions_with_index": {
      "impressions_text": null,
      "impressions_index": -1
    },
    "advertiser_about": "Contact us at www.support.gymshark.com for all your enquiries!",
    "is_delegate_page_with_linked_primary_profile": false,
    "is_political_page": false,
    "page_spend": {
      "current_week": null,
      "lifetime_by_disclaimer": [],
      "weekly_by_disclaimer": [],
      "is_political_page": false
    },
    "entity_type": "PERSON_PROFILE",
    "ig_username": "gymshark",
    "ig_followers": 8541026,
    "ig_verification": true,
    "page_alias": "Gymshark",
    "page_category": "Clothing (brand)",
    "page_cover_photo": "https://scontent-iad6-1.xx.fbcdn.net/v/t39.30808-6/486532481_1255553642852985_5814589256817883854_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=957871&_nc_ohc=X9vfvtA3GQAQ7kNvwGDN3I4&_nc_oc=AdqGKOIRmGB-cyQTvHmqHaoesGwEDt1r1DpdepV2fSlN1bbIItz9i0GZ7Z6UHUsv_84&_nc_zt=23&_nc_ht=scontent-iad6-1.xx&_nc_gid=qMEK7tHze9GvHkROy-301A&_nc_ss=79289&oh=00_AQAIaDvsyZVTcT0GbTiK9mpTjJH9LQyEl90vNocm6jPEaw&oe=6A49D0AD",
    "page_is_restricted": false,
    "page_verification": "BLUE_VERIFIED",
    "profile_photo": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/430887636_977245634017122_247869779462390570_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=XjTA6Pj3c1sQ7kNvwEstzAC&_nc_oc=AdofamIOfYo3J1hpnuwwevpaw2XUf7AJVQ1mBSIM9QXeZn_7Ki_R6viCrQZ7Hiyb6Lc&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&_nc_gid=qMEK7tHze9GvHkROy-301A&_nc_ss=79289&oh=00_AQDrEYOsNJyFob07pk6Ga9K8N1GuvbH7B35W-s0o5mX13Q&oe=6A49DD25",
    "is_profile_page": false,
    "violation_types": [],
    "verified_voice_context": null,
    "transparency_by_location": {
      "br_transparency": null,
      "eu_transparency": {
        "targets_eu": true,
        "location_audience": [
          {
            "name": "Germany",
            "num_obfuscated": 0,
            "type": "countries",
            "excluded": false
          }
        ],
        "gender_audience": "Women",
        "age_audience": {
          "min": 18,
          "max": 35
        },
        "eu_total_reach": 3578884,
        "age_country_gender_reach_breakdown": [
          {
            "country": "DE",
            "age_gender_breakdowns": [
              {
                "age_range": "18-24",
                "male": null,
                "female": 1431622,
                "unknown": null
              },
              {
                "age_range": "25-34",
                "male": null,
                "female": 2007707,
                "unknown": null
              },
              {
                "age_range": "35-44",
                "male": null,
                "female": 155816,
                "unknown": null
              },
              {
                "age_range": "Unknown",
                "male": null,
                "female": 556,
                "unknown": 2
              }
            ]
          }
        ]
      },
      "uk_transparency": null
    },
    "is_siep_advertiser_eligible_for_ai_disclosure": true,
    "is_violating_eu_siep": false
  }

---

⚙️ Input Options

Input	Type	Description
urls	array	One or more Facebook Ads Library search URLs to scrape
resultsPerUrl	number	Maximum number of ads to collect from each search URL
includeAdDetails	boolean	Enrich each ad with additional advertiser, reach, spend, and transparency data. Requires one additional request per ad and may increase scraping time.
sortBy	string	Sort ads by Impressions (High to Low) or Most Recent
activeStatus	string	Scrape Active Only ads or include both active and inactive ads
impressionsFrom	date	Only include ads with impressions on or after the selected date
impressionsTo	date	Only include ads with impressions on or before the selected date

---

📅 Smart Date Range Partitioning

Large historical searches processed through a single pagination chain may not always return the most complete dataset. To improve historical data coverage, the actor automatically partitions the selected date range into monthly requests, collects each period independently, and merges the results into a single, chronologically ordered dataset.

The date range can come from either the Facebook Ads Library search URL or the actor's Advanced Filters. If no date range is specified, the actor automatically searches the last 7 years, partitioning the entire period into monthly requests until the configured Results per URL limit is reached.

This process is fully automatic—simply provide your search URL (and optionally a date range), and the actor handles the partitioning, pagination, and result aggregation for you.

---

⚡ Apify Resurrect Run Support

The actor supports Apify resurrect runs for interrupted or partially completed scraping jobs.

If a run crashes or stops unexpectedly, the resurrected run can continue from the same scraping position instead of starting from the beginning.

---

💰 How Much Does It Cost?

Feature	Free Apify Users	Paid Apify Users
Ad Scraping	$0.75 per 1,000 results	$0.6 per 1,000 results
Ad URLs Limit	Includes 2 Ads Search URLs for testing	Unlimited URLs
Ad Limit	50 Ads per URL	Unlimited

💡 Start with a small test run to verify the output structure and estimate usage before launching larger scraping jobs.

Free users can unlock comments scraping, unlimited profiles, and higher limits by upgrading their Apify subscription: https://apify.com/pricing

---

⚠️ Limitations & Troubleshooting

• No ads returned

  Verify that the Facebook Ads Library URL is valid and returns ads when opened in your browser. Searches with no matching ads will produce an empty dataset.

• Fewer ads than expected

  The actor follows the search criteria defined by your Ads Library URL and any additional filters configured in the actor input. Check that your country, date range, active status, and other filters are not overly restrictive.

• Missing ad details

  Additional advertiser, reach, spend, and transparency information is only available when Include Ad Details is enabled and Facebook provides those details for the specific ad.

• Include Ad Details increases scraping time

  When Include Ad Details is enabled, the actor performs one additional request for each scraped ad to retrieve Facebook's See ad details information. As a result, runs with this option enabled may take longer than standard scraping runs.

• Monitoring progress

  Open the actor run and check the Logs tab to monitor scraping progress, extracted ads, and any warnings generated during the run.

---

❓ Frequently Asked Questions

Can I scrape Facebook Ads Library without logging in?

Yes. The actor extracts publicly available ads from Facebook Ads Library without requiring a Facebook account, cookies, API keys, or manual authentication.

Can I scrape ads from a specific advertiser or Facebook page?

Yes. Simply copy the advertiser's Facebook Ads Library URL and provide it as input. The actor will scrape ads matching that search.

Can I scrape Facebook Ads by keyword?

Yes. Create a keyword search on Facebook Ads Library, copy the generated search URL, and use it as input. The actor supports both keyword and advertiser-based searches.

Can I scrape ads from multiple Facebook Ads Library URLs in one run?

Yes. Provide multiple Ads Library search URLs, and the actor will process each one during the same run.

Can I filter ads by date?

Yes. You can either apply date filters while creating the Ads Library search URL or use the actor's built-in impression date filters to further refine the results.

What additional information does Include Extra Ad Details provide?

When enabled, the actor performs one additional request per ad to retrieve Facebook's See ad details information, including advertiser details, reach, spend, transparency data, audience breakdowns, and other publicly available metadata when available.

Why is my scraping run taking longer than expected?

Large searches naturally require more requests. Enabling Include Extra Ad Details also performs one additional request for every scraped ad, which may increase the total run time.

Can I export the scraped data to CSV or Excel?

Yes. Data is stored in an Apify dataset and can be exported to CSV, Excel, JSON, XML, HTML, RSS, and other formats supported by Apify.

---

💬 Support

Check the troubleshooting section above before opening an issue.

For bug reports, scraping issues, or feature requests, please open an issues on the actor page.

If you need custom scraper modifications, automation workflows, or additional extraction features, feel free to contact:

📧 kamakrazeekaushik@gmail.com

When reporting issues, please include the Actor Run ID or relevant run logs to help speed up debugging.

---

🔗 Related Actors

• 📘 Facebook Posts & Comments Scraper - Scrape Facebook posts from one or multiple public Facebook pages, including comments for every post. Configure comment limits and sorting options without using a separate comments scraper.