Facebook Ads Library Full Scraper

🚀 Overview

Facebook Ads Library Full Scraper is a powerful Apify Actor that scrapes all active ads from the Facebook Ads Library search results page and retrieves full ad details using Facebook's internal GraphQL endpoints.

This actor is designed for market research, competitor analysis, ad transparency, and data analysis, delivering structured and enriched ad data in a single JSON output.

✨ Key Features

• Scrape all ads from Facebook Ads Library
• Fetch full ad transparency details
• Persistent storage using Apify KV Store
• Single consolidated JSON output

How do I use Facebook Ads Scraper?

🔗 Input Example

{
  "url": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ES&media_type=all&q=cuidalia"
}

📤 Output Example

{
  "count": 30,
  "results": [
    {
      "ad": {
        "collation_id": "1169522781715524",
        "archive_id": "1599744897819025",
        "page_id": "122105379866001758",
        "snapshot": {
          "branded_content": null,
          "page_id": "122105379866001758",
          "page_is_deleted": false,
          "page_profile_uri": "https://www.facebook.com/61550479683863/",
          "root_reshared_post": null,
          "byline": null,
          "disclaimer_label": null,
          "page_name": "Cuidalia",
          "page_profile_picture_url": "https://scontent-mad1-1.xx.fbcdn.net/v/t39.35426-6/605715500_913259734694434_7281196601741301443_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=wlMz44JdwAsQ7kNvwFiF5Pv&_nc_oc=AdmovCvu8UMq1woAZtcmVJvLOx_8MZwosiU9Ab0l2jV0vGIwwS0usORflei0amyl22s&_nc_zt=14&_nc_ht=scontent-mad1-1.xx&_nc_gid=NzWuzFsW1Xhlvs0TbIXnRg&oh=00_Afne4gBYB_z4rqb2nfDFP8rqL_wvNAEDy8IjcwA0iQubNw&oe=69518717",
          "event": null,
          "caption": "cuidalia.org",
          "cta_text": "Comprar",
          "cards": [],
          "body": {
            "text": "Tu descanso merece la mejor almohada. CerviLux™ combina espuma viscoelástica inteligente y un diseño ergonómico 3D para liberar la presión cervical y dorsal mientras duermes. Notarás el alivio desde la primera noche, con mayor movilidad y buen humor al despertar. Con envío en 24 horas, pago contrareembolso y 30 días de garantía, no hay excusa para seguir sufriendo. Compra ya antes de que se agote el stock"
          },
          "cta_type": "SHOP_NOW",
          "display_format": "VIDEO",
          "link_description": "Pago contrareembolso",
          "link_url": "https://cuidalia.org/products/almohada-cervilux%E2%84%A2-redescubre-el-placer-de-dormir-sin-dolores",
          "images": [],
          "page_categories": [
            "Business"
          ],
          "page_like_count": 168,
          "title": "Mejor Almohada 2024",
          "videos": [
            {
              "video_hd_url": "https://video-mad1-1.xx.fbcdn.net/o1/v/t2/f2/m366/AQNXRiSJBE-S-8mD_38WE7vmgJWo4cUEQYB2eJSk-0mQegSdqGKhIDTktZnhUnCkwAawc6nu-DQyvWAPK9PZs9srdwxgPpMMe77GW1CnMgaXpQ.mp4?_nc_cat=102&_nc_sid=5e9851&_nc_ht=video-mad1-1.xx.fbcdn.net&_nc_ohc=QfMCKHQlb9kQ7kNvwG8bTbr&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuNzIwLmRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHAiLCJ4cHZfYXNzZXRfaWQiOjc5NDM3ODEwMzM0ODE1MCwiYXNzZXRfYWdlX2RheXMiOjg5LCJ2aV91c2VjYXNlX2lkIjoxMDEzOSwiZHVyYXRpb25fcyI6MjY1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=e7bf83c1231c741f&_nc_vs=HBksFQIYRWZiX2VwaGVtZXJhbC9FMDRDMTcxNjM5RTIyNjU5MzEwMzYxMjRFNEY3MThBM19tdF8xX3ZpZGVvX2Rhc2hpbml0Lm1wNBUAAsgBEgAVAhhAZmJfcGVybWFuZW50LzE3NDQ4OEY0RDBGODg1NDc4QkUzN0RDMTM1RDJCQUFDX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbs7taK8p7pAhUCKAJDMywXQHCTMzMzMzMYGWRhc2hfaDI2NC1iYXNpYy1nZW4yXzcyMHARAHUAZbaeAQA&_nc_gid=NzWuzFsW1Xhlvs0TbIXnRg&_nc_zt=28&oh=00_AflDdLORBwAZPWAmwU2vp20FfZdhtTMfsTanxyUVXoQ1yw&oe=6951904A",
              "video_preview_image_url": "https://scontent-mad2-1.xx.fbcdn.net/v/t39.35426-6/605295847_1658116952237844_1624348741431284392_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=zR89U5NfO7QQ7kNvwH_r-1C&_nc_oc=AdmcsSghXqH-JKpcAaqCvPYJT-mWsIYPFkt6XtZLXT-H0UTnjsMw93IRlW102siXzpI&_nc_zt=14&_nc_ht=scontent-mad2-1.xx&_nc_gid=NzWuzFsW1Xhlvs0TbIXnRg&oh=00_AfnU_aNpmrlgzmjI6m5_5LQENMFAcswhU0orW8U5mYkyOg&oe=6951AD70",
              "video_sd_url": "https://video-mad1-1.xx.fbcdn.net/o1/v/t2/f2/m412/AQPzrDk1xTx3CfWAJxDp_6p_bHiNJoUeZGWj-OQ7J_fCA3Yxn0BGQDOZvxQgkI7-DvRXETZNChi_3i7BCwAP1a2lmGGi0rsPWsEc_qxR-g.mp4?_nc_cat=102&_nc_sid=8bf8fe&_nc_ht=video-mad1-1.xx.fbcdn.net&_nc_ohc=aXN4FSloK5kQ7kNvwHK34gZ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5WSV9VU0VDQVNFX1BST0RVQ1RfVFlQRS4uQzMuMzYwLnN2ZV9zZCIsInhwdl9hc3NldF9pZCI6Nzk0Mzc4MTAzMzQ4MTUwLCJhc3NldF9hZ2VfZGF5cyI6ODksInZpX3VzZWNhc2VfaWQiOjEwMTM5LCJkdXJhdGlvbl9zIjoyNjUsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&_nc_gid=NzWuzFsW1Xhlvs0TbIXnRg&_nc_zt=28&oh=00_AfkZyz7VudXqbMuGdRKvWjXg-vNnWR7DugYcmrb-MJgrcw&oe=695188E8",
              "watermarked_video_hd_url": null,
              "watermarked_video_sd_url": null
            }
          ],
          "is_reshared": false,
          "extra_links": [],
          "extra_texts": [],
          "extra_images": [],
          "extra_videos": [],
          "country_iso_code": null,
          "brazil_tax_id": null,
          "additional_info": null,
          "ec_certificates": []
        }
      },
      "adDetails": {
        "data": {
          "ad_library_main": {
            "ad_details": {
              "advertiser": {
                "page": {
                  "about": {
                    "text": ""
                  },
                  "is_delegate_page_with_linked_primary_profile": false,
                  "id": "122105379866001758"
                },
                "ad_library_page_info": {
                  "page_spend": {
                    "current_week": null,
                    "lifetime_by_disclaimer": [],
                    "weekly_by_disclaimer": [],
                    "is_political_page": false
                  },
                  "page_info": {
                    "entity_type": "PERSON_PROFILE",
                    "ig_followers": null,
                    "ig_username": null,
                    "ig_verification": null,
                    "likes": 168,
                    "page_alias": "",
                    "page_category": "Servicio empresarial",
                    "page_cover_photo": "https://scontent-mad1-1.xx.fbcdn.net/v/t39.30808-6/527861875_122266716140015989_8047349016969187590_n.png?_nc_cat=101&ccb=1-7&_nc_sid=957871&_nc_ohc=l341kKewCIIQ7kNvwEAIvxj&_nc_oc=Adn110nhd5HWO7MtSH3J1Fk5dpaC0e9i7W6J991V_g94kwLt-F-qc0ixJr3lg5Mwu0s&_nc_zt=23&_nc_ht=scontent-mad1-1.xx&_nc_gid=FN4l0SyUdm31ppKAzNvtVw&oh=00_AfnT15vFIsvWW4aPPYddefSMnM4LtrUY3krtn_J646uang&oe=69519BFC",
                    "page_id": "122105379866001758",
                    "page_is_deleted": false,
                    "page_is_restricted": false,
                    "page_name": "Cuidalia",
                    "page_profile_uri": "https://facebook.com/61550479683863",
                    "page_verification": "NOT_VERIFIED",
                    "profile_photo": "https://scontent-mad2-1.xx.fbcdn.net/v/t39.30808-1/527989536_122266716248015989_4449868901303076969_n.jpg?stp=dst-jpg_s148x148_tt6&_nc_cat=100&ccb=1-7&_nc_sid=418b77&_nc_ohc=u8Zv332BW14Q7kNvwGRfntP&_nc_oc=Adl_TIWoMdzIbJTputeb9tBldcrMuyVCk1SUNv2ik387o3dbkSmhgsB0kBkhJyp4ueg&_nc_zt=24&_nc_ht=scontent-mad2-1.xx&_nc_gid=FN4l0SyUdm31ppKAzNvtVw&oh=00_Afn_RJrdDHphHVmovySTNZcCdaaG5HCwQBB0t2PWHIOl2Q&oe=6951AC1F",
                    "is_profile_page": false
                  }
                }
              },
              "aaa_info": {
                "payer_beneficiary_data": [
                  {
                    "payer": "ViewsOfAngola",
                    "beneficiary": "ViewsOfAngola"
                  }
                ],
                "targets_eu": true,
                "has_violating_payer_beneficiary": false,
                "is_ad_taken_down": false
              },
              "violation_types": [],
              "verified_voice_context": null,
              "transparency_by_location": {
                "br_transparency": null,
                "eu_transparency": {
                  "targets_eu": true,
                  "location_audience": [
                    {
                      "name": "España",
                      "num_obfuscated": 0,
                      "type": "countries",
                      "excluded": false
                    },
                    {
                      "name": "Islas Canarias, España",
                      "num_obfuscated": 0,
                      "type": "regions",
                      "excluded": true
                    },
                    {
                      "name": "Ceuta, España",
                      "num_obfuscated": 0,
                      "type": "CITY",
                      "excluded": true
                    },
                    {
                      "name": "Melilla, España",
                      "num_obfuscated": 0,
                      "type": "CITY",
                      "excluded": true
                    }
                  ],
                  "gender_audience": "Todos",
                  "age_audience": {
                    "min": 18,
                    "max": 65
                  },
                  "eu_total_reach": 172,
                  "age_country_gender_reach_breakdown": [
                    {
                      "country": "ES",
                      "age_gender_breakdowns": [
                        {
                          "age_range": "18-24",
                          "male": 2,
                          "female": null,
                          "unknown": null
                        },
                        {
                          "age_range": "25-34",
                          "male": 8,
                          "female": 8,
                          "unknown": null
                        },
                        {
                          "age_range": "35-44",
                          "male": 13,
                          "female": 26,
                          "unknown": null
                        },
                        {
                          "age_range": "45-54",
                          "male": 20,
                          "female": 26,
                          "unknown": null
                        },
                        {
                          "age_range": "55-64",
                          "male": 17,
                          "female": 27,
                          "unknown": null
                        },
                        {
                          "age_range": "65+",
                          "male": 10,
                          "female": 15,
                          "unknown": null
                        }
                      ]
                    }
                  ]
                },
                "uk_transparency": null
              },
              "is_violating_eu_siep": false
            }
          }
        },
        "extensions": {
          "is_final": true
        }
      }
    }
  ]
}

Is it legal to scrape Facebook Ads data?

Our Facebook scrapers are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. However, you should be aware that your results could contain personal data. You should not scrape personal data unless you have a legitimate reason to do so.

If you're unsure whether your reason is legitimate, consult your lawyers. You can also read our blog post on the legality of web scraping and ethical scraping.

Your feedback

We’re always working on improving the performance of our Actors. So if you’ve got any technical feedback for Facebook Ads Scraper or simply found a bug, please create an issue on the Actor’s Issues tab in Apify Console or send me at email with any questions at : managerwebmaster@proton.me.