Ad Details

Get details for a specific Facebook Ad Library entry by Ad ID. For ads with multiple versions, the title should be sourced from the cards object in the response.

GET /v1/scrape/facebook-ad-library/ad-details

Ad Details

cURL

curl --request GET \
  --url https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details \
  --header 'X-API-Key: <api-key>'

200

full

{
  "success": true,
  "data": {
    "success": true,
    "adid": 0,
    "adArchiveID": 3557423444566854,
    "archiveTypes": {},
    "categories": {
      "0": 0
    },
    "containsDigitallyCreatedMedia": false,
    "containsSensitiveContent": false,
    "collationCount": null,
    "collationID": null,
    "currency": "",
    "endDate": 1770537600,
    "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": false,
    "isAdAccountActioned": false,
    "isActive": true,
    "isProfilePage": false,
    "pageID": 1542166686041969,
    "pageInfo": null,
    "pageIsDeleted": false,
    "pageName": "Shopee",
    "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": "120214193865470606",
      "cards": {
        "0": {
          "original_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwFmnXJY&_nc_oc=AdlnFNvaCYKuwq9XQ8qjmVidpEgC_3TRxIqb58PoxGII4RvNlpS1ZZXelOrGRTVDiRs&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_Aftq91c9ZaQ-d56K6rBu0FS8M-9b29Uee7qnojLMM3cMcg&oe=698EF609",
          "resized_image_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwFmnXJY&_nc_oc=AdlnFNvaCYKuwq9XQ8qjmVidpEgC_3TRxIqb58PoxGII4RvNlpS1ZZXelOrGRTVDiRs&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_AfuX3sQHiOMO598uo26NklZhA0ExNfCZ3taoOUD7Df3e_g&oe=698EF609",
          "watermarked_resized_image_url": "",
          "body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
          "caption": "play.google.com",
          "cta_type": "INSTALL_MOBILE_APP",
          "cta_text": "Install Now",
          "title": "Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i",
          "link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
          "link_url": null
        }
      },
      "body_translations": {},
      "byline": null,
      "caption": null,
      "cta_text": "Install now",
      "dynamic_item_flags": {
        "0": {},
        "1": {},
        "2": {},
        "3": {},
        "4": {},
        "5": {}
      },
      "dynamic_versions": 2168887,
      "edited_snapshots": {},
      "effective_authorization_category": "NONE",
      "event": {},
      "extra_images": {},
      "extra_links": {},
      "extra_texts": {},
      "extra_videos": {},
      "instagram_shopping_products": {},
      "display_format": "dpa",
      "title": "Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i",
      "link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
      "link_url": null,
      "page_welcome_message": null,
      "images": {},
      "videos": {},
      "creation_time": 1734109297,
      "page_id": 1542166686041969,
      "page_name": "Shopee",
      "page_profile_picture_url": "https://scontent-ord5-3.xx.fbcdn.net/v/t39.35426-6/470221141_598719742707546_5888493433237993681_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=rSXK_QyCxC8Q7kNvwEJLNRh&_nc_oc=Adkotq79Vg-clup96CofB6e4_0atik8CLIDQRbGslKeCSjvmpzIND5FgFp9JRplqnhI&_nc_zt=14&_nc_ht=scontent-ord5-3.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_Aft00gURPqoSqKaZ-_0N1INoE__hk8n-oRC7QUK7pAILuA&oe=698EF1AC",
      "page_categories": {
        "2301": "App page"
      },
      "page_entity_type": "person_profile",
      "page_is_profile_page": false,
      "instagram_actor_name": "Shopee",
      "instagram_profile_pic_url": "https://scontent-ord5-1.xx.fbcdn.net/v/t39.35426-6/470129690_856310040046044_288555385467158142_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=XmmalUqE8poQ7kNvwHyCVDV&_nc_oc=AdmgsLfFrlgbJgAHDdqmEBbHuVmQwr6ERPjQ7BgFcUL9kkh0aXbHp5GYyvulpwu2t4A&_nc_zt=14&_nc_ht=scontent-ord5-1.xx&_nc_gid=ceTavZj3Slz0PhFXoOc1lA&oh=00_AfthSLf9YFw1Q_hMR1i1KeLnwrhrxkSvFmVQLcxjlI-teQ&oe=698ED902",
      "instagram_url": "",
      "instagram_handle": "",
      "is_reshared": false,
      "version": 3,
      "body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
      "brazil_tax_id": null,
      "branded_content": null,
      "current_page_name": "Shopee",
      "disclaimer_label": null,
      "page_like_count": 31605854,
      "page_profile_uri": "https://www.facebook.com/ShopeeID/",
      "page_is_deleted": false,
      "root_reshared_post": null,
      "cta_type": "INSTALL_MOBILE_APP",
      "additional_info": null,
      "ec_certificates": null,
      "country_iso_code": null,
      "instagram_branded_content": null,
      "final_url": null
    },
    "spend": null,
    "startDate": 1749106800,
    "stateMediaRunLabel": null,
    "publisherPlatform": {
      "0": "facebook",
      "1": "instagram",
      "2": "audience_network",
      "3": "messenger"
    },
    "menuItems": {},
    "targetedOrReachedCountries": {},
    "totalActiveTime": null,
    "url": "https://www.facebook.com/ads/library?id=3557423444566854",
    "startDateString": "2025-06-05T07:00:00.000Z",
    "endDateString": "2026-02-08T08:00:00.000Z",
    "aaa_info": null
  },
  "creditsUsed": 1
}

💳 1 credit per request

Authorizations

X-API-Key · string · header · required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

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. This is a new feature, so let me know if its not working how you expected.

Example:

false

trim · boolean

Set to true for a trimmed down version of the response

Example:

false

Response

200

application/json

Successful response

Key Response Fields:

• data.adArchiveID: The actual ad ID (note: adid is always 0 — always use adArchiveID)
• data.isActive: Whether the ad is currently running
• data.pageName: Name of the Facebook page running the ad
• data.pageID: Facebook page ID
• data.startDateString: ISO timestamp of when the ad started running
• data.endDateString: ISO timestamp of when the ad stopped (or is scheduled to stop)
• data.publisherPlatform: Platforms the ad runs on (e.g., facebook, instagram, messenger)
• data.snapshot.title: Ad headline/title
• data.snapshot.body: Ad body copy
• data.snapshot.cta_text: Call-to-action button text (e.g., "Install Now", "Shop Now")
• data.snapshot.cta_type: CTA type identifier (e.g., "INSTALL_MOBILE_APP", "SHOP_NOW")
• data.snapshot.cards[0].title: Title from the first carousel card (for multi-creative ads)
• data.snapshot.cards[0].body: Body text from the first carousel card