Search
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-ad-library/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/search"
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/search', 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/search",
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/search"
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/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/search")
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,
"searchResults": {
"0": {
"ad_archive_id": "3557423444566854",
"collation_count": null,
"collation_id": null,
"page_id": "1542166686041969",
"snapshot": {
"branded_content": null,
"page_id": "1542166686041969",
"page_is_deleted": false,
"page_profile_uri": "https://www.facebook.com/ShopeeID/",
"root_reshared_post": null,
"byline": null,
"disclaimer_label": null,
"page_name": "Shopee",
"page_profile_picture_url": "https://scontent-sea5-1.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_QyCxC8Q7kNvwHN9GoD&_nc_oc=AdmFQsk1-VK3eJgrXrvzhDA2jhrgoyFEetbvpzaj2tJ_-ILRIk9zuXoXjL4_zTW5k90&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AftMfYBhS0x5QyIVir0gyPX5aDVKCr9-tmyN5y9KiOyQ3Q&oe=698EF1AC",
"event": null,
"caption": null,
"cta_text": "Install now",
"cards": {
"0": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwHIxhWy&_nc_oc=AdkcRBfyU14_kztmwtxHdu6JAIp9oyWpl0Mb7Muv37TWLO1f34v097FZEUiMEzn7jes&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfuzvDcXeX47i6tgRKDZN8g4ax2VrIawJFg0ojU6s6_3qA&oe=698EF609",
"resized_image_url": "https://scontent-sea5-1.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=oiwI8ksepdMQ7kNvwHIxhWy&_nc_oc=AdkcRBfyU14_kztmwtxHdu6JAIp9oyWpl0Mb7Muv37TWLO1f34v097FZEUiMEzn7jes&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfuBVblFasRryqzwLh8zo-kNfpDcNyKuYR2jBaCnewbI6w&oe=698EF609",
"watermarked_resized_image_url": ""
},
"1": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "RIG WEIRWEI KT 8900D WEIERWEI KT 8900D KT8900D FULLSET ANTENA SG M507",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470173196_3920002954924359_2454042766045661521_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=meQ76ufoNOwQ7kNvwFj9tKO&_nc_oc=AdkyXy8HTQMe0qNBKNjZU_sQ6f3P8xyhyOtYXwMm_E9Occ2Jx4fqEEVld-x-KifSWcw&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Afs-ADzahavdtW_x8Kc51MFapJYBiTfIPJvUYG0_HRS6kQ&oe=698EEAC1",
"resized_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470173196_3920002954924359_2454042766045661521_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=meQ76ufoNOwQ7kNvwFj9tKO&_nc_oc=AdkyXy8HTQMe0qNBKNjZU_sQ6f3P8xyhyOtYXwMm_E9Occ2Jx4fqEEVld-x-KifSWcw&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfsfvZM4VgNre8-U71BZxgGfE6vVQcJjhJ1_jw9-C3u08A&oe=698EEAC1",
"watermarked_resized_image_url": ""
},
"2": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "MOTOR DRAIN RETRACTOR MESIN CUCI QA12-11 Sharp",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470211809_1572295404162432_1405298997540799487_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=h0X1KYBQX2MQ7kNvwHSStvE&_nc_oc=AdlbdXd8OX-75jDfiWjF6XukoW-O0oV7fML61Wiv1jmb2W4OeA2TNw-tzU1VdfTxExc&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AftMXhbi_Cai9BQDIngOT-SMBtZ3OqiwKl-pU-OQsJ-JLQ&oe=698EFC2A",
"resized_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470211809_1572295404162432_1405298997540799487_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=h0X1KYBQX2MQ7kNvwHSStvE&_nc_oc=AdlbdXd8OX-75jDfiWjF6XukoW-O0oV7fML61Wiv1jmb2W4OeA2TNw-tzU1VdfTxExc&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Afs2fT3J0WnwH8dQIJ2ahsOIw1ON4yHBH7M68WzrShD93Q&oe=698EFC2A",
"watermarked_resized_image_url": ""
},
"3": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "Speaker Advance M180BT CLEON Extra Power Sound",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470222582_1959933984501909_2903789649647055229_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xuDA6Rsjwk8Q7kNvwFoicWj&_nc_oc=Adlodi---rK8rJrjKm0q6RsHztRXD3gPXks2xSwAXIyCNr9G7MYc8qLt1_7o3f2pDZE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Aftfxinwsr_8EJ1hD5ipaZtHzl8zcRqVw2M9Q-ENGAFW9A&oe=698EDE3C",
"resized_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470222582_1959933984501909_2903789649647055229_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xuDA6Rsjwk8Q7kNvwFoicWj&_nc_oc=Adlodi---rK8rJrjKm0q6RsHztRXD3gPXks2xSwAXIyCNr9G7MYc8qLt1_7o3f2pDZE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfudphgBZpm_C1tfGx40GOrQlevH3sDIaSu3vNvrasixVg&oe=698EDE3C",
"watermarked_resized_image_url": ""
},
"4": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "MIYAKO BLENDER 152 GF",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470180004_1108525107445100_4079140962851973128_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BvKxQezNM3UQ7kNvwHBsHtQ&_nc_oc=AdlnPRAfmySr8r6cNoml6jhdGlLN_MoAKXEt31XN12xnMnUzVEkw1gQSFjP090lByaE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfuHglu79S5s5VQ_NoQBNDrb_wQmJNHIsuyeZH0g6tvrMw&oe=698EFEE8",
"resized_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470180004_1108525107445100_4079140962851973128_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BvKxQezNM3UQ7kNvwHBsHtQ&_nc_oc=AdlnPRAfmySr8r6cNoml6jhdGlLN_MoAKXEt31XN12xnMnUzVEkw1gQSFjP090lByaE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfsByrh5R-Ar4xMfDQ2ecGDPmipX5nr8MueyDK47xfrJig&oe=698EFEE8",
"watermarked_resized_image_url": ""
},
"5": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "Refill Cartridge EPSON LQ2190 LQ2180",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470139011_2051329141983784_744592750991496450_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Q7N5DlG7nM8Q7kNvwF1ChXj&_nc_oc=AdnW8qGWl7H9b6cmw5AEf2hw-T50tQeUQ34nzwoOKOQr5slqk9owPdso_Hn65z6aa1c&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Afvwk5fJEqTUS325FphbVqI17LAMbaW4007fx_EeMnIaUA&oe=698EF5F9",
"resized_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470139011_2051329141983784_744592750991496450_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Q7N5DlG7nM8Q7kNvwF1ChXj&_nc_oc=AdnW8qGWl7H9b6cmw5AEf2hw-T50tQeUQ34nzwoOKOQr5slqk9owPdso_Hn65z6aa1c&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AftZ_f87f2MZWS_JFis8Ipksj_hV3hQc2ClCu9NXwf1ByA&oe=698EF5F9",
"watermarked_resized_image_url": ""
}
},
"body": {
"text": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!"
},
"cta_type": "INSTALL_MOBILE_APP",
"display_format": "DPA",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"images": {},
"page_categories": {
"0": "App page"
},
"page_like_count": 31604727,
"title": "Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i",
"videos": {},
"is_reshared": false,
"extra_links": {},
"extra_texts": {},
"extra_images": {},
"extra_videos": {},
"country_iso_code": null,
"brazil_tax_id": null,
"additional_info": null,
"ec_certificates": {}
},
"is_active": true,
"has_user_reported": false,
"report_count": null,
"menu_items": {},
"state_media_run_label": null,
"page_is_deleted": false,
"page_name": "Shopee",
"impressions_with_index": {
"impressions_text": null,
"impressions_index": -1
},
"gated_type": "ELIGIBLE",
"categories": {
"0": "UNKNOWN"
},
"is_aaa_eligible": false,
"contains_digital_created_media": false,
"reach_estimate": null,
"currency": "",
"spend": null,
"end_date": 1770537600,
"publisher_platform": {
"0": "FACEBOOK",
"1": "INSTAGRAM",
"2": "AUDIENCE_NETWORK",
"3": "MESSENGER"
},
"start_date": 1749106800,
"contains_sensitive_content": false,
"total_active_time": null,
"regional_regulation_data": {
"finserv": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"tw_anti_scam": {
"is_limited_delivery": false
}
},
"hide_data_status": "NONE",
"fev_info": null,
"ad_id": null,
"targeted_or_reached_countries": {},
"url": "https://www.facebook.com/ads/library?id=3557423444566854",
"start_date_string": "2025-06-05T07:00:00.000Z",
"end_date_string": "2026-02-08T08:00:00.000Z"
}
},
"searchResultsCount": 50001,
"cursor": "AQHSicCO9fh9qVceDdIDslVCzlYfLurHC3BbhpOe758WriyDp4MMbtO7d49HvJ1GpO2z"
},
"credits_used": 1
}Facebook Ad Library
Search
Search the Facebook (Meta) Ad Library by keyword. GET requests are capped at approximately 1,500 results due to cursor size limits. For larger result sets, use this endpoint as a POST request with the query parameters passed in the request body.
GET
/
v1
/
scrape
/
facebook-ad-library
/
search
Search
curl --request GET \
--url https://api.sociavault.com/v1/scrape/facebook-ad-library/search \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.sociavault.com/v1/scrape/facebook-ad-library/search"
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/search', 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/search",
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/search"
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/search")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.sociavault.com/v1/scrape/facebook-ad-library/search")
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,
"searchResults": {
"0": {
"ad_archive_id": "3557423444566854",
"collation_count": null,
"collation_id": null,
"page_id": "1542166686041969",
"snapshot": {
"branded_content": null,
"page_id": "1542166686041969",
"page_is_deleted": false,
"page_profile_uri": "https://www.facebook.com/ShopeeID/",
"root_reshared_post": null,
"byline": null,
"disclaimer_label": null,
"page_name": "Shopee",
"page_profile_picture_url": "https://scontent-sea5-1.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_QyCxC8Q7kNvwHN9GoD&_nc_oc=AdmFQsk1-VK3eJgrXrvzhDA2jhrgoyFEetbvpzaj2tJ_-ILRIk9zuXoXjL4_zTW5k90&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AftMfYBhS0x5QyIVir0gyPX5aDVKCr9-tmyN5y9KiOyQ3Q&oe=698EF1AC",
"event": null,
"caption": null,
"cta_text": "Install now",
"cards": {
"0": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470155166_598763855959846_2891375126439340067_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=oiwI8ksepdMQ7kNvwHIxhWy&_nc_oc=AdkcRBfyU14_kztmwtxHdu6JAIp9oyWpl0Mb7Muv37TWLO1f34v097FZEUiMEzn7jes&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfuzvDcXeX47i6tgRKDZN8g4ax2VrIawJFg0ojU6s6_3qA&oe=698EF609",
"resized_image_url": "https://scontent-sea5-1.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=oiwI8ksepdMQ7kNvwHIxhWy&_nc_oc=AdkcRBfyU14_kztmwtxHdu6JAIp9oyWpl0Mb7Muv37TWLO1f34v097FZEUiMEzn7jes&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfuBVblFasRryqzwLh8zo-kNfpDcNyKuYR2jBaCnewbI6w&oe=698EF609",
"watermarked_resized_image_url": ""
},
"1": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "RIG WEIRWEI KT 8900D WEIERWEI KT 8900D KT8900D FULLSET ANTENA SG M507",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470173196_3920002954924359_2454042766045661521_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=meQ76ufoNOwQ7kNvwFj9tKO&_nc_oc=AdkyXy8HTQMe0qNBKNjZU_sQ6f3P8xyhyOtYXwMm_E9Occ2Jx4fqEEVld-x-KifSWcw&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Afs-ADzahavdtW_x8Kc51MFapJYBiTfIPJvUYG0_HRS6kQ&oe=698EEAC1",
"resized_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470173196_3920002954924359_2454042766045661521_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=meQ76ufoNOwQ7kNvwFj9tKO&_nc_oc=AdkyXy8HTQMe0qNBKNjZU_sQ6f3P8xyhyOtYXwMm_E9Occ2Jx4fqEEVld-x-KifSWcw&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfsfvZM4VgNre8-U71BZxgGfE6vVQcJjhJ1_jw9-C3u08A&oe=698EEAC1",
"watermarked_resized_image_url": ""
},
"2": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "MOTOR DRAIN RETRACTOR MESIN CUCI QA12-11 Sharp",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470211809_1572295404162432_1405298997540799487_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=h0X1KYBQX2MQ7kNvwHSStvE&_nc_oc=AdlbdXd8OX-75jDfiWjF6XukoW-O0oV7fML61Wiv1jmb2W4OeA2TNw-tzU1VdfTxExc&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AftMXhbi_Cai9BQDIngOT-SMBtZ3OqiwKl-pU-OQsJ-JLQ&oe=698EFC2A",
"resized_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470211809_1572295404162432_1405298997540799487_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=h0X1KYBQX2MQ7kNvwHSStvE&_nc_oc=AdlbdXd8OX-75jDfiWjF6XukoW-O0oV7fML61Wiv1jmb2W4OeA2TNw-tzU1VdfTxExc&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Afs2fT3J0WnwH8dQIJ2ahsOIw1ON4yHBH7M68WzrShD93Q&oe=698EFC2A",
"watermarked_resized_image_url": ""
},
"3": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "Speaker Advance M180BT CLEON Extra Power Sound",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470222582_1959933984501909_2903789649647055229_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xuDA6Rsjwk8Q7kNvwFoicWj&_nc_oc=Adlodi---rK8rJrjKm0q6RsHztRXD3gPXks2xSwAXIyCNr9G7MYc8qLt1_7o3f2pDZE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Aftfxinwsr_8EJ1hD5ipaZtHzl8zcRqVw2M9Q-ENGAFW9A&oe=698EDE3C",
"resized_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470222582_1959933984501909_2903789649647055229_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xuDA6Rsjwk8Q7kNvwFoicWj&_nc_oc=Adlodi---rK8rJrjKm0q6RsHztRXD3gPXks2xSwAXIyCNr9G7MYc8qLt1_7o3f2pDZE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfudphgBZpm_C1tfGx40GOrQlevH3sDIaSu3vNvrasixVg&oe=698EDE3C",
"watermarked_resized_image_url": ""
},
"4": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "MIYAKO BLENDER 152 GF",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470180004_1108525107445100_4079140962851973128_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BvKxQezNM3UQ7kNvwHBsHtQ&_nc_oc=AdlnPRAfmySr8r6cNoml6jhdGlLN_MoAKXEt31XN12xnMnUzVEkw1gQSFjP090lByaE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfuHglu79S5s5VQ_NoQBNDrb_wQmJNHIsuyeZH0g6tvrMw&oe=698EFEE8",
"resized_image_url": "https://scontent-sea5-1.xx.fbcdn.net/v/t39.35426-6/470180004_1108525107445100_4079140962851973128_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=BvKxQezNM3UQ7kNvwHBsHtQ&_nc_oc=AdlnPRAfmySr8r6cNoml6jhdGlLN_MoAKXEt31XN12xnMnUzVEkw1gQSFjP090lByaE&_nc_zt=14&_nc_ht=scontent-sea5-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AfsByrh5R-Ar4xMfDQ2ecGDPmipX5nr8MueyDK47xfrJig&oe=698EFEE8",
"watermarked_resized_image_url": ""
},
"5": {
"body": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!",
"cta_type": "INSTALL_MOBILE_APP",
"caption": "play.google.com",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"title": "Refill Cartridge EPSON LQ2190 LQ2180",
"cta_text": "Install Now",
"video_hd_url": null,
"video_preview_image_url": null,
"video_sd_url": null,
"watermarked_video_hd_url": null,
"watermarked_video_sd_url": null,
"image_crops": {},
"original_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470139011_2051329141983784_744592750991496450_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Q7N5DlG7nM8Q7kNvwF1ChXj&_nc_oc=AdnW8qGWl7H9b6cmw5AEf2hw-T50tQeUQ34nzwoOKOQr5slqk9owPdso_Hn65z6aa1c&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_Afvwk5fJEqTUS325FphbVqI17LAMbaW4007fx_EeMnIaUA&oe=698EF5F9",
"resized_image_url": "https://scontent-sea1-1.xx.fbcdn.net/v/t39.35426-6/470139011_2051329141983784_744592750991496450_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=Q7N5DlG7nM8Q7kNvwF1ChXj&_nc_oc=AdnW8qGWl7H9b6cmw5AEf2hw-T50tQeUQ34nzwoOKOQr5slqk9owPdso_Hn65z6aa1c&_nc_zt=14&_nc_ht=scontent-sea1-1.xx&_nc_gid=3uIkgC1NToT2e4UTk7o85w&oh=00_AftZ_f87f2MZWS_JFis8Ipksj_hV3hQc2ClCu9NXwf1ByA&oe=698EF5F9",
"watermarked_resized_image_url": ""
}
},
"body": {
"text": "Ngga perlu takut pesanan telat! Belanja kilat di Shopee Garansi Tepat Waktu, dapat Gratis Voucher Kalau Telat!"
},
"cta_type": "INSTALL_MOBILE_APP",
"display_format": "DPA",
"link_description": "GARANSI TEPAT WAKTU di Shopee! 🧡",
"link_url": null,
"images": {},
"page_categories": {
"0": "App page"
},
"page_like_count": 31604727,
"title": "Myroots Tempered Glass Blue Light Vivo Y20i - Y20S - Y30i - Y50i",
"videos": {},
"is_reshared": false,
"extra_links": {},
"extra_texts": {},
"extra_images": {},
"extra_videos": {},
"country_iso_code": null,
"brazil_tax_id": null,
"additional_info": null,
"ec_certificates": {}
},
"is_active": true,
"has_user_reported": false,
"report_count": null,
"menu_items": {},
"state_media_run_label": null,
"page_is_deleted": false,
"page_name": "Shopee",
"impressions_with_index": {
"impressions_text": null,
"impressions_index": -1
},
"gated_type": "ELIGIBLE",
"categories": {
"0": "UNKNOWN"
},
"is_aaa_eligible": false,
"contains_digital_created_media": false,
"reach_estimate": null,
"currency": "",
"spend": null,
"end_date": 1770537600,
"publisher_platform": {
"0": "FACEBOOK",
"1": "INSTAGRAM",
"2": "AUDIENCE_NETWORK",
"3": "MESSENGER"
},
"start_date": 1749106800,
"contains_sensitive_content": false,
"total_active_time": null,
"regional_regulation_data": {
"finserv": {
"is_deemed_finserv": false,
"is_limited_delivery": false
},
"tw_anti_scam": {
"is_limited_delivery": false
}
},
"hide_data_status": "NONE",
"fev_info": null,
"ad_id": null,
"targeted_or_reached_countries": {},
"url": "https://www.facebook.com/ads/library?id=3557423444566854",
"start_date_string": "2025-06-05T07:00:00.000Z",
"end_date_string": "2026-02-08T08:00:00.000Z"
}
},
"searchResultsCount": 50001,
"cursor": "AQHSicCO9fh9qVceDdIDslVCzlYfLurHC3BbhpOe758WriyDp4MMbtO7d49HvJ1GpO2z"
},
"credits_used": 1
}💳 1 credit per request
Authorizations
Query Parameters
Keyword to search for
Example:
"running"
Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.
Available options:
total_impressions, relevancy_monthly_grouped Example:
"total_impressions"
If you want to search by exact phrase or not
Available options:
keyword_unordered, keyword_exact_phrase Example:
"keyword_unordered"
Search for all ads or only political and issue ads
Available options:
all, political_and_issue_ads Example:
"all"
This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.
Example:
"ALL"
Status of the ad. Defaults to ACTIVE.
Available options:
ALL, ACTIVE, INACTIVE Example:
"ACTIVE"
Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme.
Available options:
ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE Example:
"ALL"
Impressions start date. Needs to be in YYYY-MM-DD format.
Example:
"2025-01-05"
Impressions end date. Needs to be in YYYY-MM-DD format.
Example:
"2025-02-16"
Cursor to paginate through results
Example:
"AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"
Set to true for a trimmed down version of the response
Example:
false
Response
Successful response
Key Response Fields:
data.searchResults[0].ad_archive_id: The actual ad ID (use this —ad_idis always null)data.searchResults[0].is_active: Whether the ad is currently runningdata.searchResults[0].page_id: Facebook page ID running the addata.searchResults[0].page_name: Facebook page namedata.searchResults[0].start_date_string: ISO timestamp of when the ad starteddata.searchResults[0].end_date_string: ISO timestamp of when the ad ended or will enddata.searchResults[0].publisher_platform: Platforms the ad runs ondata.searchResults[0].snapshot.title: Ad headline/titledata.searchResults[0].snapshot.body.text: Ad body copydata.searchResults[0].snapshot.cta_text: Call-to-action button textdata.searchResults[0].snapshot.cards[0].original_image_url: Ad creative image URLdata.searchResultsCount: Total number of matching ads founddata.cursor: Pagination cursor — pass ascursorto get further results
⌘I