Skip to main content
GET
/
v1
/
scrape
/
facebook-ad-library
/
ad-details
Ad Details
curl --request GET \
  --url https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details \
  --header 'X-API-Key: <api-key>'
{ "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 }

Documentation Index

Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt

Use this file to discover all available pages before exploring further.

💳 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

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