Ad Details
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
},
"credits_used": 1
}Facebook Ad Library
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 --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/ad-details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"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
},
"credits_used": 1
}💳 1 credit per request
Authorizations
Query Parameters
Facebook Ad Id
Example:
"702369045530963"
Facebook Ad URL
Example:
"https://www.facebook.com/ads/library?id=1185617869915074"
Get the transcript of the ad. This is a new feature, so let me know if its not working how you expected.
Example:
false
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:adidis always 0 — always useadArchiveID)data.isActive: Whether the ad is currently runningdata.pageName: Name of the Facebook page running the addata.pageID: Facebook page IDdata.startDateString: ISO timestamp of when the ad started runningdata.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/titledata.snapshot.body: Ad body copydata.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
⌘I