VOOZH about

URL: https://apify.com/igolaizola/facebook-ad-library-scraper

⇱ Facebook (Meta) Ads Library Scraper · Apify

👁 Facebook (Meta) Ads Library Scraper avatar

Facebook (Meta) Ads Library Scraper

Pricing

$15.00/month + usage

Go to Apify Store

Facebook (Meta) Ads Library Scraper

Extract powerful ad insights from Meta's Facebook Ads Library. Scrape comprehensive data including IDs, ad text, images, links, and page details to fuel digital marketing strategies and competitive research. Optimize and boost campaigns with current, actionable ad data for maximum impact.

Pricing

$15.00/month + usage

Rating

5.0

(9)

Developer

👁 Iñigo Garcia Olaizola

Iñigo Garcia Olaizola

Maintained by Community

Actor stats

44

Bookmarked

1.1K

Total users

38

Monthly active users

0.98 hours

Issues response

2 days ago

Last modified

Share

Facebook (Meta) Ad Library Scraper

🤖 What does Facebook Ad Library Scraper do?

Facebook Ad Library Scraper enables you to extract data from the Meta Ad Library effortlessly. It collects detailed ad information, helping you analyze and monitor ad campaigns running on Facebook. This tool is especially useful for gathering insights on ad creatives and targeting details.

The scraper collects key ad details such as:

  • Ad Archive ID – Unique identifier of the ad in the library
  • Ad Text – The body copy of the advertisement
  • Caption and CTA – Captions and call-to-action text used in the ad
  • Images – Visual assets of the ad
  • Link URLs and Descriptions – Destination URLs and accompanying text
  • Ad Title – Title or headline of the ad
  • Page Information – Page name, profile link, and picture URL
  • Run Dates – Start and end dates for the ad campaign

💡 Why scrape the Facebook Ad Library?

Facebook's Ad Library is a comprehensive resource for understanding how advertisers reach audiences on social media. Scraping the Ad Library allows you to:

  • Conduct Competitive Analysis: Monitor your competitors' ad strategies and creative trends.
  • Perform Market Research: Identify popular ad themes, messaging styles, and creative approaches.
  • Analyze Political or Issue-Based Advertising: Gain insights into ad spending and targeting in political or socially relevant campaigns.
  • Track Ad Performance: Collect data over time to understand shifts in messaging or creative elements.
  • Enhance Digital Marketing Strategies: Learn from successful ad examples and refine your own advertising campaigns.

🚀 How to scrape the Facebook Ad Library

Getting started with Facebook Ad Library Scraper is straightforward:

  1. Configure Your Input:
    • Max Items: Set the maximum number of ads to scrape.
    • Search Query: Define a keyword to filter ads (e.g., "pizza").
    • Country: Optionally specify a country code to filter ads by region.
    • Proxy Configuration: Enable Apify Proxy with the provided residential proxy settings for improved reliability.
  2. Run the Scraper:
    • Click on Run to start the scraping process.
  3. Access Your Data:
    • Once complete, preview or download the data from the Dataset tab for further analysis.

📝 Input Parameters

The scraper supports the following input parameters to tailor your data collection:

Below is the updated section with the new category parameter added:

📝 Input Parameters

The scraper supports the following input parameters to tailor your data collection:

ParameterTypeRequiredDescription
maxItemsIntegerYesMaximum number of ads to scrape. Must be at least 1. Default is 10.
queryStringYesSearch query to filter ads in the library. E.g., "pizza".
advertisersArrayNoArray of advertiser page IDs to filter the search.
pageIdStringNoPage ID to fetch all ads for a specific page without a query.
countryStringNoCountry code to filter ads by region. E.g., "US". Default is set to all countries.
categoryStringNoCategory to filter ads. Options include: "All ads", "Issues, elections or politics", "Housing", "Employment", and "Financial products and services". Default is "all".
mediaTypeStringNoMedia type to filter ads. Options include: "All media types", "Images", "Memes", "Images and Memes", "Videos", and "No image or video". Default is "all".
sortByStringNoSort order for results. Options include: "Most recent" and "Impressions: high to low". Default is "mostRecent".
activeStatusStringNoActive status to filter ads. Options include: "Active ads", "Inactive ads", and "Active and Inactive". Default is "active".
fetchDetailsBooleanNoWhen true, fetch additional advertiser and transparency information for each ad and store it under _details. This generates more requests and can make runs slower.
proxyConfigurationObjectNoProxy settings to control how requests are routed. Default is set to use Apify's residential proxy group.

Example input:

{
"maxItems":10,
"query":"pizza",
"country":"US",
"fetchDetails":true,
"sortBy":"mostRecent",
"category":"Employment",
"proxyConfiguration":{
"useApifyProxy":true,
"apifyProxyGroups":["RESIDENTIAL"]
}
}

📊 Results

If fetchDetails=true, each item includes an _details object with extra advertiser and transparency data fetched from the ad detail endpoint.

Warning: enabling fetchDetails increases request volume and usually makes the actor slower.

Example output snippet:

[
{
"ad_archive_id":"574945338232404",
"ad_id":null,
"archive_types":[],
"categories":["UNKNOWN"],
"collation_count":1,
"collation_id":"958408599520543",
"contains_digital_created_media":false,
"contains_sensitive_content":false,
"currency":"",
"end_date":1741334400,
"entity_type":"PERSON_PROFILE",
"fev_info":null,
"finserv_ad_data":{
"is_deemed_finserv":false,
"is_limited_delivery":false
},
"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":false,
"is_active":true,
"is_profile_page":false,
"menu_items":[],
"page_id":"194210777106441",
"page_is_deleted":false,
"page_name":"Muppet Mania",
"political_countries":[],
"publisher_platform":["FACEBOOK"],
"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":"Limited Edition - The Muppets. Order here https://instock.click/uFO7UYBo Store here https://instock.click/6ONATBB3"
},
"branded_content":null,
"brazil_tax_id":null,
"byline":null,
"caption":"https://instock.click/uFO7UYBo",
"cards":[],
"cta_text":"Shop now",
"cta_type":"SHOP_NOW",
"country_iso_code":null,
"current_page_name":"Muppet Mania",
"disclaimer_label":null,
"display_format":"IMAGE",
"event":null,
"images":[
{
"original_image_url":"https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/466796040_966955675270816_7713969994976429478_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=MwuKQ9q2dqQQ7kNvgEQWv67&_nc_oc=AdiSj7lwZTQSIBGo_6s0sJbdZir2w_YLjvTL63GYBenPP7vhEUYnhgjRmRwopVt1LE4&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=AMaDjxNM8hqmHDixF9hivU_&oh=00_AYGGq6E8bLhbY_m-ShVQ5k4Ln-3OoTSWBNY7xkoUM7XTbw&oe=67D3D3F4",
"resized_image_url":"https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/467006778_3951980601753306_1553261810657438408_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=F2DWoA0iQ6UQ7kNvgHADUQS&_nc_oc=AdgU6xpffxVcMl5fZhkDvu4tak0JOdxGBazObDSNAg3GkCuMdNuKGZPckOC4BbknE40&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=AMaDjxNM8hqmHDixF9hivU_&oh=00_AYETWc9v481I5S_eg1Khiswx8WbcbxqBWg0mXkjBUZ8WiA&oe=67D3B1A6",
"watermarked_resized_image_url":"",
"image_crops":[]
}
],
"is_reshared":false,
"link_description":"Made In USA - Shipping WORLDWIDE !!!",
"link_url":"https://instock.click/uFO7UYBo",
"page_categories":["Clothing (Brand)","Clothing"],
"page_entity_type":"PERSON_PROFILE",
"page_id":"194210777106441",
"page_is_deleted":false,
"page_is_profile_page":false,
"page_like_count":284,
"page_name":"Muppet Mania",
"page_profile_picture_url":"https://scontent-det1-1.xx.fbcdn.net/v/t39.35426-6/467123654_2384554008553482_852696039130416010_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=a2qRTTbNZ4IQ7kNvgHLRoUM&_nc_oc=AdhxfytiSwoXqIgz237JULf2JgCjp6B6vs8N_ZYud9lEcLd-Rsdz82gwhDs5rckOEi4&_nc_zt=14&_nc_ht=scontent-det1-1.xx&_nc_gid=AMaDjxNM8hqmHDixF9hivU_&oh=00_AYGVjYJiWsnSXiBK1bwxDxCNi7JIWwIaEPDOwEMRG7TtFA&oe=67D3AACD",
"page_profile_uri":"https://www.facebook.com/61554673251967/",
"root_reshared_post":null,
"title":"Only available for a limited time!",
"videos":[],
"additional_info":null,
"ec_certificates":[],
"extra_images":[],
"extra_links":[],
"extra_texts":[],
"extra_videos":[]
},
"spend":null,
"start_date":1732089600,
"state_media_run_label":null,
"targeted_or_reached_countries":[],
"total_active_time":null
},
{
"ad_archive_id":"1301653854216941",
"ad_id":null,
"archive_types":[],
"categories":["UNKNOWN"],
"collation_count":1,
"collation_id":"1314177176526490",
"contains_digital_created_media":false,
"contains_sensitive_content":false,
"currency":"",
"end_date":1741507200,
"entity_type":"PERSON_PROFILE",
"fev_info":null,
"finserv_ad_data":{
"is_deemed_finserv":false,
"is_limited_delivery":false
},
"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":false,
"is_active":true,
"is_profile_page":false,
"menu_items":[],
"page_id":"113580465338014",
"page_is_deleted":false,
"page_name":"MetroHealth",
"political_countries":[],
"publisher_platform":[
"FACEBOOK",
"INSTAGRAM",
"AUDIENCE_NETWORK",
"MESSENGER"
],
"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 seen. Be heard. Be well. Be close to home. Find a primary care provider near you at Brooklyn Health Center."
},
"branded_content":null,
"brazil_tax_id":null,
"byline":null,
"caption":"metrohealth.org",
"cards":[
{
"body":"Primary Care Near You",
"caption":"metrohealth.org",
"cta_text":"Book Now",
"cta_type":"BOOK_TRAVEL",
"image_crops":[],
"link_description":"Primary Care Near You",
"link_url":"https://www.metrohealth.org/physician?utm_source=facebook&utm_medium=display&utm_campaign=sr_brooklyn_25&utm_term={{ad.id}}&utm_content=5219096-e32-n-m-c{{campaign.id}}-g{{adset.id}}-a{{ad.id}}-u-cat-k-mod#sort=@providersortname ascending&f:_locations=[Brooklyn Health Center]&f:_acceptingnewpatients=[New Patients]&dq=Primary Care",
"original_image_url":"https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/477031806_794050673179535_4488087468182736763_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Crpv-toSO5oQ7kNvgES4PYj&_nc_oc=AdjrIOfT9GsOFlUGgJvFXBC_ynw7HU7xER8FLZFYlIV6HJNDzK-AvQn0yEAnqacLVtc&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=Ad6vkHBiuMXMM-NWkXLrm4N&oh=00_AYGUEQdZ_-xSOZbScd6pbLVq6jyZK8ZgeTKihWc84tyyNw&oe=67D3B404",
"resized_image_url":"https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/476640968_1131891544921725_4575722954592771427_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=b8nqZ6HpU78Q7kNvgFiPifO&_nc_oc=Adhfq7J_nV_3Fzp2rq7Bzwo5-vXNhFyNPXHu0bUeFLm3OAfqQiW2qmN9LIqLU0VPnEU&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=Ad6vkHBiuMXMM-NWkXLrm4N&oh=00_AYFGYXfWTJNTqcO7u6hTN7kQyYXc4JJ8-06XvTQxvVdv5g&oe=67D3BB46",
"watermarked_resized_image_url":"",
"title":"MetroHealth Brooklyn Health Center",
"video_hd_url":null,
"video_preview_image_url":null,
"video_sd_url":null,
"watermarked_video_hd_url":null,
"watermarked_video_sd_url":null
},
{
"body":"Primary Care Near You",
"caption":"metrohealth.org",
"cta_text":"Book Now",
"cta_type":"BOOK_TRAVEL",
"image_crops":[],
"link_description":"Primary Care Near You",
"link_url":"https://www.metrohealth.org/physician?utm_source=facebook&utm_medium=display&utm_campaign=sr_brooklyn_25&utm_term={{ad.id}}&utm_content=5219096-e32-n-m-c{{campaign.id}}-g{{adset.id}}-a{{ad.id}}-u-cat-k-mod#sort=@providersortname ascending&f:_locations=[Brooklyn Health Center]&f:_acceptingnewpatients=[New Patients]&dq=Primary Care",
"original_image_url":"https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/477784167_605872365394439_6503609582302738994_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=_fCcutciYEIQ7kNvgEE_4Ie&_nc_oc=AdhkvvEdz9KM3xzpUgSFNUZSCXMTXaVJJxVaBVS16EtolHQG_Q-smZTDLELROyCBFmc&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=Ad6vkHBiuMXMM-NWkXLrm4N&oh=00_AYFOW7A3fMGb84TSYgCeO3vLlA9HpSwkujMveRCxq7S3VA&oe=67D3D72D",
"resized_image_url":"https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/477308427_3944113485877256_1788753183015552393_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=r_2g_8P6Z-MQ7kNvgGdCsFi&_nc_oc=Adg5GPWZ0r0_jvbDm8CJ0xVFOrVHsM-j9ztlTsUjAOdFi1xFZ8_92AXp-uxAz4uJOf0&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=Ad6vkHBiuMXMM-NWkXLrm4N&oh=00_AYEFKN8Pqgm45SJ7p5EXwQLD9LQP_-9QAXPIjacwEoVkGQ&oe=67D3AE90",
"watermarked_resized_image_url":"",
"title":"MetroHealth Brooklyn Health Center",
"video_hd_url":null,
"video_preview_image_url":null,
"video_sd_url":null,
"watermarked_video_hd_url":null,
"watermarked_video_sd_url":null
}
],
"cta_text":null,
"cta_type":null,
"country_iso_code":null,
"current_page_name":"MetroHealth",
"disclaimer_label":null,
"display_format":"CAROUSEL",
"event":null,
"images":[],
"is_reshared":false,
"link_description":null,
"link_url":"https://www.metrohealth.org/",
"page_categories":["Hospital"],
"page_entity_type":"PERSON_PROFILE",
"page_id":"113580465338014",
"page_is_deleted":false,
"page_is_profile_page":false,
"page_like_count":16153,
"page_name":"MetroHealth",
"page_profile_picture_url":"https://scontent-ord5-2.xx.fbcdn.net/v/t39.35426-6/476609870_909946101016355_8282851577385213530_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=QrOSUqV76JYQ7kNvgGxi22U&_nc_oc=AdgAdjRtkHmtsnGc9Jsdw3ER65Mh3gwZALwiZ_CSD7AJA_8oJJMHOm4rS9QSTAaYwG4&_nc_zt=14&_nc_ht=scontent-ord5-2.xx&_nc_gid=Ad6vkHBiuMXMM-NWkXLrm4N&oh=00_AYGdtOP3ykUYLZbE7TRr0DZrh2xBmKHdpk5jqaKE4Zoh2Q&oe=67D3ADAC",
"page_profile_uri":"https://www.facebook.com/metrohealthCLE/",
"root_reshared_post":null,
"title":"MetroHealth",
"videos":[],
"additional_info":null,
"ec_certificates":[],
"extra_images":[],
"extra_links":[],
"extra_texts":[],
"extra_videos":[]
},
"spend":null,
"start_date":1739433600,
"state_media_run_label":null,
"targeted_or_reached_countries":[],
"total_active_time":null
}
]

🌍 Proxy Usage

To ensure high success rates and minimize detection risks, Facebook Ad Library Scraper utilizes Apify's proxy infrastructure. Benefits include:

  • Enhanced reliability and consistent access to Facebook's Ad Library.
  • Ability to scrape data from different geographic locations.
  • Protection against IP blocking during high-frequency data collection.

⚖️ Legal Considerations

When using Facebook Ad Library Scraper, please consider the following:

  • Respect the Platform's Terms: Ensure your use case complies with Facebook's terms of service and policies.
  • Avoid Overloading Servers: Implement reasonable request rates to avoid overwhelming the website.
  • Data Privacy Regulations: Be aware of and comply with personal data protection laws like GDPR.
  • Legal Advice: If uncertain about the legal implications, consult with a legal professional.

For more insights on web scraping legality, please refer to our blog post: is web scraping legal?

You might also like

Facebook Ad Library Scraper

corner_cutter/facebook-ad-library-scraper

Comprehensive Meta ad library tool that fetches all ads for a given Facebook Ad Library URL or page URL. Extract ad creatives, copy, targeting info, and more.

601

3.9

Meta (Facebook) Ad Library Scraper - Efficient & Fast

automly/facebook-ad-library-scraper

Scrape the Meta Ad Library for Facebook and Instagram ads. Extract ad copy, images, videos, spend, impressions, and advertiser transparency data. No account or API key required.

365

3.3

Facebook Ads Library Scraper

scraper-engine/facebook-ads-library-scraper

The Facebook Ads Library Scraper extracts ad data from Facebook’s Ad Library, including advertiser details, ad text, impressions, and targeting info. Ideal for ad research, marketing insights, and competitor analysis, it delivers clean, structured data for analysis or integration via API.

👁 User avatar

Scraper Engine

399

4.2

Facebook Ad Library Scraper

agenscrape/facebook-ad-library-scraper

Extract ads from Facebook Ad Library instantly. Get complete ad details, images, videos, page info, impressions, and targeting data. Just paste the Ad Library URL and run. Fast, reliable extraction for competitor research and market analysis.

260

Facebook Ads Library Scraper — Meta Ads + Instagram Data

sourabhbgp/facebook-ads-scraper

Scrape Facebook Ads Library (Meta Ad Library) with 57 fields per ad — no login needed. Get ad copy, images, videos, CTAs, run dates, Instagram followers, page verification, AI-content flag, EU transparency. Search by keyword, advertiser, or paste any Ad Library URL.

👁 User avatar

Sourabh Kumar

86

Meta (Facebook) Ad Library Scraper - Fast & Reliable

whoareyouanas/meta-ad-scraper

Scrape Meta ads in seconds - no fluff, just instant access to the ad data and insights you need. Get detailed ad information including title, description, images, videos, CTA, Social platform and metadata

👁 User avatar

Anas Nadeem

2.4K

4.9

Meta (Facebook) Ad Scrapper (Using Ad Library URL) (Premium)

scrapeio/meta-facebook-ad-scrapper-using-ad-library-url-premium

Scrape every Meta ad (Facebook, Instagram, Messenger, Audience Network) from the Ad Library by keyword, Facebook Page ID, or Ad Library URL. Sort by total impressions or most recent. Extract creatives, copy, CTAs, impressions, and spend ranges. 100+ languages. No Meta Graph API or developer app.

887

4.8

Facebook Ads Library Scraper

apify/facebook-ads-scraper

Extract advertising data from Facebook, Instagram, WhatsApp, Threads, Messenger. Get ad details, publishers, prices, reach estimates, impressions, links, images, ad IDs, timestamps, and more from Meta Ad Library. Export ad data, schedule runs via API, and integrate with other tools or AI workflows.

24K

2.5

Meta Ad Library Scraper Pro

webdatalabs/meta-ad-library-scraper

Extract competitor ads from Meta's Ad Library (Facebook, Instagram, Messenger, Audience Network). Get ad copy, creatives, targeting data, sentiment analysis, and track changes over time.

👁 User avatar

WebDataLabs

433

5.0

Facebook Ad Library Scraper

practicaltools/facebook-ad-library-scraper

Scrapes ads from the Facebook Ad Library. Accepts search URLs or Facebook page URLs and returns structured ad data.

👁 User avatar

Practical Tools

44