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: | Parameter | Type | Required | Description | | -------------------- | ------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | maxItems | Integer | Yes | Maximum number of ads to scrape. Must be at least 1. Default is 10. | | query | String | Yes | Search query to filter ads in the library. E.g., "pizza". | | country | String | No | Country code to filter ads by region. E.g., "US". Default is set to all countries. | | category | String | No | Category to filter ads. Options include: "All ads", "Issues, elections or politics", "Housing", "Employment", and "Financial products and services". Default is "all". | | mediaType | String | No | Media type to filter ads. Options include: "All media types", "Images", "Memes", "Images and Memes", "Videos", and "No image or video". Default is "all". | | activeStatus | String | No | Active status to filter ads. Options include: "Active ads", "Inactive ads", and "Active and Inactive". Default is "active". | | proxyConfiguration | Object | No | Proxy settings to control how requests are routed. Default is set to use Apify's residential proxy group. | Example input: json { "maxItems": 10, "query": "pizza", "country": "US", "category": "Employment", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] } } ## 📊 Results Example output snippet: json [ { "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?