Skip to main content
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>'
{
  "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"
  },
  "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

​
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:

  • is_active: Whether the ad is currently running
  • ad_archive_id: The actual ad id