Ad Details

Pass the Ad ID and get back details about the ad. Be careful that if an ad has multiple versions, you're actually going to want to get the title from the 'cards' object. If you ask for the transcipt, we will only transcribe the video if it's under 2 minutes.

1 creditper request
GET
/v1/facebook/adLibrary/ad

🤖 Why Code When AI Can Do It For You?

Stop writing code like it's 1970! Let AI do the heavy lifting - click the sparkles to copy a perfectly formatted prompt for ChatGPT, Claude, or your favorite AI assistant.

curl "https://api.scrapecreators.com/v1/facebook/adLibrary/ad" \
  -H "x-api-key: "
{
  "adid": 0,
  "adArchiveID": 702369045530963,
  "archiveTypes": [],
  "categories": [
    0
  ],
  "containsDigitallyCreatedMedia": false,
  "containsSensitiveContent": false,
  "collationCount": null,
  "collationID": null,
  "currency": "",
  "endDate": 1747983600,
  "entityType": "person_profile",
  "fevInfo": null,
  "finServAdData": {
    "is_deemed_finserv": false,
    "is_limited_delivery": false
  },
  "gatedType": "eligible",
  "hasUserReported": false,
  "hiddenSafetyData": false,
  "hideDataStatus": "NONE",
  "impressionsWithIndex": {
    "impressionsText": null,
    "impressionsIndex": -1
  },
  "isAAAEligible": true,
  "isAdAccountActioned": false,
  "isActive": false,
  "isProfilePage": false,
  "pageID": 166258896830103,
  "pageInfo": null,
  "pageIsDeleted": false,
  "pageName": "Porto Montenegro",
  "politicalCountries": [],
  "reachEstimate": null,
  "regionalRegulationData": {
    "finserv": {
      "is_deemed_finserv": false,
      "is_limited_delivery": false
    },
    "tw_anti_scam": {
      "is_limited_delivery": false
    }
  },
  "reportCount": null,
  "snapshot": {
    "ad_creative_id": 1066536401993375,
    "cards": [],
    "body_translations": {},
    "byline": null,
    "caption": "www.portomontenegro.com",
    "cta_text": "Learn more",
    "dynamic_item_flags": {},
    "dynamic_versions": null,
    "edited_snapshots": [],
    "effective_authorization_category": "NONE",
    "event": [],
    "extra_images": [],
    "extra_links": [],
    "extra_texts": [],
    "extra_videos": [],
    "instagram_shopping_products": [],
    "display_format": "video",
    "title": null,
    "link_description": null,
    "link_url": "https://www.portomontenegro.com/attractions-events/boka-place-grand-opening/",
    "page_welcome_message": null,
    "images": [],
    "videos": [
      {
        "video_hd_url": "https://video-lga3-1.xx.fbcdn.net/v/t42.1790-2/491479560_702369072197627_5775200790449116407_n.?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=hwX4c3kvwLsQ7kNvwFl2d_Q&_nc_oc=AdlG8xo51B_VLh8mOjXqjG0Mad3sb7Q-j-8ZZzP-s_j3sHdDkDUJwrrmYd7R9UyfaOA&_nc_zt=28&_nc_ht=video-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfKBmgSKPootHiGNb9xgL2zB15Omax_hVTaa2bzRsjzn_w&oe=6843812F",
        "video_sd_url": "https://video-lga3-1.xx.fbcdn.net/v/t42.1790-2/499448662_702369075530960_5981246750517589666_n.?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=cg4ziP_jjpkQ7kNvwEd7Ymr&_nc_oc=AdlMwa_AeLm6TknZdG_S5L26DNIi_LeoUM_iw58qxM3z4hkKIeJOinIjGuvP4T1zl8I&_nc_zt=28&_nc_ht=video-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfK-DFpMEBShiZb3JUsjv_0EAC7saMqut0dI5fJGTAK8hQ&oe=6843A9D6",
        "watermarked_video_sd_url": "",
        "watermarked_video_hd_url": "",
        "video_preview_image_url": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.35426-6/499149696_1837810423819060_5242520759436861939_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=h-Gc3OVWRsQQ7kNvwENP9GF&_nc_oc=AdnHZtuO7JE08Yptly2LO3_sk-XEiw2Dx_ZHE2FyzV8AY1Y-zm24L3Na7ap1rdpO-f8&_nc_zt=14&_nc_ht=scontent-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfKr3Go0i5YNKCoOfapvk0fO7DxfBFYazfPdNnjbBHnnEA&oe=684381BA"
      }
    ],
    "creation_time": 1747908203,
    "page_id": 598631456674530,
    "page_name": "Porto Montenegro Experience",
    "page_profile_picture_url": "https://scontent-lga3-3.xx.fbcdn.net/v/t39.35426-6/498588182_739875508369121_8639482247199838788_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CL4JqnVkRzgQ7kNvwEVYWpq&_nc_oc=AdkdPEIQctV4dKggCb8YIFBwzdb5ghgYdYUDAEqQ8mcGtCVOr3QZZ_-kg9lil60EMOg&_nc_zt=14&_nc_ht=scontent-lga3-3.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfIJsuOZfJyoWeHNlOp18Nn7Y1xmM79egJLCXKItT0-qjQ&oe=68439344",
    "page_categories": {
      "197251360301109": "Marina"
    },
    "page_entity_type": "person_profile",
    "page_is_profile_page": false,
    "instagram_actor_name": "Porto Montenegro Experience",
    "instagram_profile_pic_url": "https://scontent-lga3-2.xx.fbcdn.net/v/t39.35426-6/499922917_1078294804160843_5583552140592065526_n.jpg?_nc_cat=101&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=EWHzIxDAk20Q7kNvwFgPQrS&_nc_oc=AdmbvB4ypz9F2BrlQ7FcUMcvfR5JvoCggHJ1a4Ntu3ZXQ8KoiUCOTCYzvZ1z6gYiIJo&_nc_zt=14&_nc_ht=scontent-lga3-2.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfJd0SOIGy12aEqb4GS4Kz86YOdg3NpQ5OL9W-RRnBHPBQ&oe=6843A343",
    "instagram_url": "",
    "instagram_handle": "",
    "is_reshared": false,
    "version": 3,
    "body": "Reflections ripple, light gathers,<br /> and tomorrow brings a new rhythm to the square. <br /> <br /> One day until the Grand Opening of Boka Place.",
    "brazil_tax_id": null,
    "branded_content": {
      "page_id": 166258896830103,
      "page_name": "Porto Montenegro",
      "page_profile_picture_url": "https://scontent-lga3-1.xx.fbcdn.net/v/t39.35426-6/499920502_2382687582132053_334434608727983440_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=zJEq2b_i4xwQ7kNvwEhuat_&_nc_oc=AdnryrPnSzR5YCB7wO-EVqpswUJ2l8xDDXiCjJN6b4rhZJ2c8809t5QTDa7OwUq9ueU&_nc_zt=14&_nc_ht=scontent-lga3-1.xx&_nc_gid=PBbgsjxhy8iorGrJjaavZw&oh=00_AfLZibsXYNxUNvp9LT4tOJWbf-3uFIkWN4e5ke-s5FqGdw&oe=68438B15",
      "page_categories": {
        "197251360301109": "Marina"
      },
      "current_page_name": "Porto Montenegro",
      "page_profile_uri": "https://www.facebook.com/portomontenegrotivat/",
      "page_is_deleted": false
    },
    "current_page_name": "Porto Montenegro Experience",
    "disclaimer_label": null,
    "page_like_count": 1,
    "page_profile_uri": "https://www.facebook.com/61575286107814/",
    "page_is_deleted": false,
    "root_reshared_post": null,
    "cta_type": "LEARN_MORE",
    "additional_info": null,
    "ec_certificates": null,
    "country_iso_code": null,
    "instagram_branded_content": {
      "instagram_bc_sponsor_id": "17841400741682419",
      "instagram_bc_sponsor_name": "porto_montenegro"
    }
  },
  "spend": null,
  "startDate": 1747897200,
  "stateMediaRunLabel": null,
  "publisherPlatform": [
    "facebook",
    "instagram",
    "audience_network"
  ],
  "menuItems": [],
  "targetedOrReachedCountries": [],
  "totalActiveTime": 41782,
  "url": "https://www.facebook.com/ads/library?id=702369045530963",
  "startDateString": "2025-05-22T07:00:00.000Z",
  "endDateString": "2025-05-23T07:00:00.000Z",
  "aaa_info": {
    "targets_eu": true,
    "location_audience": [
      {
        "name": "Dubrovnik, Croatia",
        "num_obfuscated": 0,
        "type": "CITY",
        "excluded": false
      }
    ],
    "gender_audience": "All",
    "age_audience": {
      "min": 18,
      "max": 65
    },
    "eu_total_reach": 1657,
    "age_country_gender_reach_breakdown": [
      {
        "country": "HR",
        "age_gender_breakdowns": [
          {
            "age_range": "45-54",
            "male": 101,
            "female": 77,
            "unknown": 4
          },
          {
            "age_range": "55-64",
            "male": 55,
            "female": 55,
            "unknown": 1
          },
          {
            "age_range": "65+",
            "male": 37,
            "female": 29,
            "unknown": null
          },
          {
            "age_range": "18-24",
            "male": 161,
            "female": 152,
            "unknown": 7
          },
          {
            "age_range": "25-34",
            "male": 374,
            "female": 238,
            "unknown": 8
          },
          {
            "age_range": "35-44",
            "male": 196,
            "female": 133,
            "unknown": 5
          }
        ]
      }
    ],
    "payer_beneficiary_data": [
      {
        "payer": "Porto Montenegro",
        "beneficiary": "Porto Montenegro"
      }
    ],
    "has_violating_payer_beneficiary": false,
    "is_ad_taken_down": false
  }
}

Headers

x-api-key
string
required

Your Scrape Creators API key

Query Parameters

id
string

Facebook Ad Id

Example:
702369045530963
url
string

Facebook Ad URL

Example:
https://www.facebook.com/ads/library?id=1185617869915074
get_transcript
boolean

Get the transcript of the ad. Only works if the video is under 2 minutes.

Example:
false
trim
boolean

Set to true for a trimmed down version of the response

Example:
false

Response Field Explanations

adArchiveID
This is the ad id. You'd think it'd be 'adid', but facebook decided to make it confusing 🤦‍♂️