Search

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

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))

}

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
}

GET

scrape

facebook-ad-library

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

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))

}

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

X-API-Key

string

header

required

API key for authentication. Format: sk_live_xxxxxxxxxxxxx

Get your API key from the Dashboard.

Query Parameters

query

string

required

Keyword to search for

Example:

"running"

sort_by

enum<string>

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"

search_type

enum<string>

If you want to search by exact phrase or not

Available options:

keyword_unordered,

keyword_exact_phrase

Example:

"keyword_unordered"

ad_type

enum<string>

Search for all ads or only political and issue ads

Available options:

all,

political_and_issue_ads

Example:

"all"

country

string

This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL.

Example:

"ALL"

status

enum<string>

Status of the ad. Defaults to ACTIVE.

Available options:

ALL,

ACTIVE,

INACTIVE

Example:

"ACTIVE"

media_type

enum<string>

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"

start_date

string

Impressions start date. Needs to be in YYYY-MM-DD format.

Example:

"2025-01-05"

end_date

string

Impressions end date. Needs to be in YYYY-MM-DD format.

Example:

"2025-02-16"

cursor

string

Cursor to paginate through results

Example:

"AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"

trim

boolean

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_id is always null)
data.searchResults[0].is_active: Whether the ad is currently running
data.searchResults[0].page_id: Facebook page ID running the ad
data.searchResults[0].page_name: Facebook page name
data.searchResults[0].start_date_string: ISO timestamp of when the ad started
data.searchResults[0].end_date_string: ISO timestamp of when the ad ended or will end
data.searchResults[0].publisher_platform: Platforms the ad runs on
data.searchResults[0].snapshot.title: Ad headline/title
data.searchResults[0].snapshot.body.text: Ad body copy
data.searchResults[0].snapshot.cta_text: Call-to-action button text
data.searchResults[0].snapshot.cards[0].original_image_url: Ad creative image URL
data.searchResultsCount: Total number of matching ads found
data.cursor: Pagination cursor — pass as cursor to get further results

Overview

Getting Started

AI Agents (MCP)

TikTok

TikTok Shop

Instagram

YouTube

LinkedIn

Facebook

Facebook Marketplace

Facebook Ad Library

Google Ad Library

LinkedIn Ad Library

TikTok Ad Library

Twitter

Reddit

Threads

Google

Pinterest

Twitch

Account

Authorizations

Query Parameters

Response