Facebook Ads Library

Using Facebook Ads Library API you can scrape Facebook Ads results without worrying about proxy rotation and data parsing. Our API is fast and reliable.

You have to send a GET request to https://api.scrapingdog.com/facebook/ads with the below-given parameters.

Parameters

Parameter
Description

api_key

required

Your personal API key. Available on your dashboard. Type: String

html

This will return the full HTML of the Facebook Ads page. Default Value - false Type - Boolean

Search Query

Parameter
Description

url required

This is the Facebook Ads Library URL. Type: String

API Example

curl "https://api.scrapingdog.com/facebook/ads?api_key=APIKEY&url=https://www.facebook.com/ads/library/?ad_type=all%26active_status=active%26country=ALL%26media_type=all%26is_targeted_country=false%26search_type=page%26view_all_page_id=434174436675167"

API Response

{
    "search_information": {
        "total_results": 6906,
        "ad_library_page_info": {
            "page_info": {
                "related_pages": [],
                "has_blank_ads": false,
                "hidden_ads": 0,
                "page_is_deleted": false,
                "page_profile_uri": "https://www.facebook.com/apple/",
                "page_name": "Apple",
                "page_id": "434174436675167",
                "page_verification": "BLUE_VERIFIED",
                "entity_type": "PERSON_PROFILE",
                "page_alias": "apple",
                "likes": 15086922,
                "page_category": "Product/service",
                "ig_verification": true,
                "ig_username": "apple",
                "ig_followers": 34250648
            }
        },
        "page": {
            "name": "Apple",
            "id": "434174436675167",
            "about": {
                "text": ""
            },
            "is_delegate_page_with_linked_primary_profile": false,
            "confirmed_page_owner": {
                "name": null,
                "information": null,
                "id": null
            },
            "pages_transparency_info": {
                "history_items": [
                    {
                        "event_time": 1469689202,
                        "item_type": "NAME_CHANGE"
                    },
                    {
                        "event_time": 1368821488,
                        "item_type": "NAME_CHANGE"
                    },
                    {
                        "event_time": 1364569106,
                        "item_type": "CREATION"
                    }
                ],
                "state_media_country_label": null,
                "id": "dHJhbnNwYXJlbmN5OjQzNDE3NDQzNjY3NTE2Nw==",
                "admin_locations": {
                    "admin_country_counts": [
                        {
                            "count": 44,
                            "country": {
                                "iso_name": "United States",
                                "id": "109078688522"
                            }
                        },
                        {
                            "count": 21,
                            "country": {
                                "iso_name": "Japan",
                                "id": "92195839502"
                            }
                        },
                        {
                            "count": 10,
                            "country": {
                                "iso_name": "South Korea",
                                "id": "102898199121"
                            }
                        },
                        {
                            "count": 9,
                            "country": {
                                "iso_name": "United Kingdom",
                                "id": "112449756806"
                            }
                        },
                        {
                            "count": 6,
                            "country": {
                                "iso_name": "Singapore",
                                "id": "98055937300"
                            }
                        },
                        {
                            "count": 5,
                            "country": {
                                "iso_name": "Taiwan",
                                "id": "92311338177"
                            }
                        },
                        {
                            "count": 4,
                            "country": {
                                "iso_name": "India",
                                "id": "92061054329"
                            }
                        },
                        {
                            "count": 3,
                            "country": {
                                "iso_name": "Brazil",
                                "id": "90994063252"
                            }
                        },
                        {
                            "count": 2,
                            "country": {
                                "iso_name": "Canada",
                                "id": "111030136976"
                            }
                        },
                        {
                            "count": 1,
                            "country": {
                                "iso_name": "Australia",
                                "id": "109353030906"
                            }
                        }
                    ]
                }
            },
            "ad_library_page_targeting_insight": {
                "ad_library_page_has_siep_ads": false,
                "ad_library_page_targeting_summary": {
                    "detailed_spend": [],
                    "ds": "2025-07-24",
                    "main_currency": "",
                    "total_num_ads": 0,
                    "total_spend_formatted": "0",
                    "is_30_day_available": true,
                    "is_90_day_available": true
                },
                "ad_library_page_targeting_gender": [],
                "ad_library_page_targeting_language": [],
                "ad_library_page_targeting_location": [],
                "ad_library_page_targeting_age": [],
                "ad_library_page_targeting_custom_audience": [],
                "ad_library_page_targeting_lookalike_audience": [],
                "ad_library_page_targeting_detailed": []
            }
        }
    },
    "ads": [
        {
            "ad_archive_id": "718034764409958",
            "page_id": "434174436675167",
            "snapshot": {
                "branded_content": null,
                "page_id": "434174436675167",
                "page_is_deleted": false,
                "page_profile_uri": "https://www.facebook.com/apple/",
                "root_reshared_post": null,
                "byline": null,
                "disclaimer_label": null,
                "page_name": "Apple",
                "page_profile_picture_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/515055589_1438490120398528_2730795644277145437_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Dw4xJbWTymcQ7kNvwF5THdK&_nc_oc=Adll_TF3OSQduvvH-I-9O1IU-fwZJLn1eX_2wgvgoLF8EVQTPbzot1HsgBsrLulvSLE&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfRpkmNgorvDjcXGl7SpytPeMsI9mEOpI0uU7QTuTCgQLw&oe=68928A84",
                "body": {
                    "text": "{{product.brand}}"
                },
                "is_reshared": false,
                "brazil_tax_id": null,
                "caption": "apple.com",
                "cards": [
                    {
                        "body": "هلا وسهلا في متجر Apple Store Online. اختبر تجربة تسوّق جديدة تصلك مباشرة من Apple.",
                        "caption": "",
                        "cta_text": "Shop Now",
                        "cta_type": "SHOP_NOW",
                        "image_crops": [],
                        "link_description": "متجر Apple Store Online.",
                        "link_url": "https://www.apple.com/sa-ar/store?cid=rmc-sa-soc-retail-25asoksa-socl-rbwmt-skvf-mmtmkr-randf-aos-mul-adevt-gnt-broa-strlp-ufnnl-saar-ksaaso-video-916ar-6s-asodat-annce-lau-na-na-na-na-05693811",
                        "original_image_url": null,
                        "resized_image_url": null,
                        "watermarked_resized_image_url": null,
                        "title": "هلا بالسعودية.",
                        "video_hd_url": "https://video-iad3-1.xx.fbcdn.net/v/t42.1790-2/514641451_715725958057397_2994827344229798208_n.?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=PPuQzEI7cC4Q7kNvwHtNe4z&_nc_oc=AdnELwgalxJI2Q30SiCWFnP1UnB2h4J7DIM4uyorludAl6wAYXiSFdaGLxBXc4pxJP4&_nc_zt=28&_nc_ht=video-iad3-1.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfT-0p149-_EpCpG4rfq-WOg4VYJGb6soBH4DcudxxAWcw&oe=6892783F",
                        "video_preview_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/514394761_23888249474164431_7365357028949109381_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rcn-uSQ3O7UQ7kNvwH-CK1j&_nc_oc=AdlWvCpwnpqT6UyRWQDMwcC-_9CfF8L8bSXT4fAtN0vMg1JXwgSrSs8y3wONLCWEB-A&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfQ3yw4JurmP2zifmQJtb2qIAnCq9K0eoopmNBdap76PsA&oe=68926C21",
                        "video_sd_url": "https://video-iad3-1.xx.fbcdn.net/v/t42.1790-2/515408346_23886838577625696_2286207129998533182_n.mp4?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=mxgl9CbE6c4Q7kNvwEPsX4H&_nc_oc=AdlITf9mwOsHHV2UV_bqcHINQ0tqwAEKp33i8ikx-mZC_XzQf2q-QT7-G_Tx5StaiLc&_nc_zt=28&_nc_ht=video-iad3-1.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfR3vllcTJqE0pue1S4NZ2UsJy7uNGF2GVnJ1HFK7WjuMA&oe=68929645",
                        "watermarked_video_hd_url": "",
                        "watermarked_video_sd_url": ""
                    },
                    {
                        "body": "هلا وسهلا في متجر Apple Store Online. اختبر تجربة تسوّق جديدة تصلك مباشرة من Apple.",
                        "caption": "",
                        "cta_text": "Shop Now",
                        "cta_type": "SHOP_NOW",
                        "image_crops": [],
                        "link_description": "متجر Apple Store Online.",
                        "link_url": "https://www.apple.com/sa-ar/store?cid=rmc-sa-soc-retail-25asoksa-socl-rbwmt-skvf-mmtmkr-randf-aos-mul-adevt-gnt-broa-strlp-ufnnl-saar-ksaaso-video-916ar-6s-asodat-annce-lau-na-na-na-na-05693811",
                        "original_image_url": null,
                        "resized_image_url": null,
                        "watermarked_resized_image_url": null,
                        "title": "هلا بالسعودية.",
                        "video_hd_url": "https://video-iad3-1.xx.fbcdn.net/v/t42.1790-2/514641451_715725958057397_2994827344229798208_n.?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=PPuQzEI7cC4Q7kNvwHtNe4z&_nc_oc=AdnELwgalxJI2Q30SiCWFnP1UnB2h4J7DIM4uyorludAl6wAYXiSFdaGLxBXc4pxJP4&_nc_zt=28&_nc_ht=video-iad3-1.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfT-0p149-_EpCpG4rfq-WOg4VYJGb6soBH4DcudxxAWcw&oe=6892783F",
                        "video_preview_image_url": "https://scontent-iad3-2.xx.fbcdn.net/v/t39.35426-6/514394761_23888249474164431_7365357028949109381_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rcn-uSQ3O7UQ7kNvwH-CK1j&_nc_oc=AdlWvCpwnpqT6UyRWQDMwcC-_9CfF8L8bSXT4fAtN0vMg1JXwgSrSs8y3wONLCWEB-A&_nc_zt=14&_nc_ht=scontent-iad3-2.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfQ3yw4JurmP2zifmQJtb2qIAnCq9K0eoopmNBdap76PsA&oe=68926C21",
                        "video_sd_url": "https://video-iad3-1.xx.fbcdn.net/v/t42.1790-2/515408346_23886838577625696_2286207129998533182_n.mp4?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=mxgl9CbE6c4Q7kNvwEPsX4H&_nc_oc=AdlITf9mwOsHHV2UV_bqcHINQ0tqwAEKp33i8ikx-mZC_XzQf2q-QT7-G_Tx5StaiLc&_nc_zt=28&_nc_ht=video-iad3-1.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfR3vllcTJqE0pue1S4NZ2UsJy7uNGF2GVnJ1HFK7WjuMA&oe=68929645",
                        "watermarked_video_hd_url": "",
                        "watermarked_video_sd_url": ""
                    },
                    {
                        "body": "هلا وسهلا في متجر Apple Store Online. اختبر تجربة تسوّق جديدة تصلك مباشرة من Apple.",
                        "caption": "",
                        "cta_text": "Shop Now",
                        "cta_type": "SHOP_NOW",
                        "image_crops": [],
                        "link_description": "متجر Apple Store Online.",
                        "link_url": "https://www.apple.com/sa-ar/store?cid=rmc-sa-soc-retail-25asoksa-socl-rbwmt-skvf-mmtmkr-randf-aos-mul-adevt-gnt-broa-strlp-ufnnl-saar-ksaaso-video-916ar-6s-asodat-annce-lau-na-na-na-na-05693811",
                        "original_image_url": null,
                        "resized_image_url": null,
                        "watermarked_resized_image_url": null,
                        "title": "هلا بالسعودية.",
                        "video_hd_url": "https://video-iad3-2.xx.fbcdn.net/v/t42.1790-2/514353634_715725954724064_5169853444118104323_n.?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=x29hUCWAKloQ7kNvwFGoXq0&_nc_oc=AdkxvBDZn-S2cEQKMU4Pg-qzgt-CkqQ1qYkd1JOS2U5U83_M3bWyH2pe-J73z5kEsDA&_nc_zt=28&_nc_ht=video-iad3-2.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfRXKKKXG_6V0QIifFkVOSv8o6WSjdDQAhY8TZtrFvLGlQ&oe=689291B7",
                        "video_preview_image_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.35426-6/515451637_1275462477572568_8582440907700127233_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=nYz_n9IiDO4Q7kNvwEW_fEV&_nc_oc=AdmyeUv2iRJHw3eLorLu1qSnHtI0pUkbT3wOAyGMeFNpqsDo7hpRcvaS8by2Lf9ZMN0&_nc_zt=14&_nc_ht=scontent-iad3-1.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfR9wa3NJCdDuZyIhSXj7iKzyPWeX3RhvViV9WoGTn8SOQ&oe=68928DD7",
                        "video_sd_url": "https://video-iad3-1.xx.fbcdn.net/v/t42.1790-2/514574206_1780161036217286_2509408380439855349_n.mp4?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Qhvqbi1Tyf8Q7kNvwHN5VrB&_nc_oc=Adn8YCndEjv8eee7zW4-r7JVAQe7cx4k7bD7RMAU5_lDJzCIMSluEPbj78hq9pg1qow&_nc_zt=28&_nc_ht=video-iad3-1.xx&_nc_gid=MQC6F3G9VpljD8ORKAXmSw&oh=00_AfTF8zIIrHie47owDG1h5mZWefMKk4Dj6tNTobf4vT7dfA&oe=68928751",
                        "watermarked_video_hd_url": "",
                        "watermarked_video_sd_url": ""
                    }
                ],
                "cta_text": "Shop now",
                "cta_type": "SHOP_NOW",
                "country_iso_code": null,
                "current_page_name": "Apple",
                "display_format": "DCO",
                "event": null,
                "images": [],
                "link_description": "{{product.description}}",
                "link_url": "https://www.apple.com/sa-ar/store?cid=rmc-sa-soc-retail-25asoksa-socl-rbwmt-skvf-mmtmkr-randf-aos-mul-adevt-gnt-broa-strlp-ufnnl-saar-ksaaso-video-916ar-6s-asodat-annce-lau-na-na-na-na-05693811",
                "page_categories": [
                    "Product/service"
                ],
                "page_entity_type": "PERSON_PROFILE",
                "page_is_profile_page": false,
                "page_like_count": 14559600,
                "title": "{{product.name}}",
                "videos": [],
                "additional_info": null,
                "ec_certificates": [],
                "extra_images": [],
                "extra_links": [],
                "extra_texts": [],
                "extra_videos": []
            },
            "is_active": true,
            "page_name": "Apple",
            "categories": [
                "UNKNOWN"
            ],
            "collation_count": null,
            "end_date": 1754031600,
            "entity_type": "PERSON_PROFILE",
            "gated_type": "ELIGIBLE",
            "hide_data_status": "NONE",
            "impressions_with_index": {
                "impressions_text": null,
                "impressions_index": -1
            },
            "publisher_platform": [
                "FACEBOOK",
                "INSTAGRAM"
            ],
            "start_date": 1753945200,
            "total_active_time": 47605
        },
      ........

Last updated