Facebook Ad Library Search API

Search Meta Ad Library by keyword. Use GET normally; for long pagination cursors, use POST with the same parameters in the JSON body.

1 creditper request
POST
/v1/facebook/adLibrary/search/ads
curl --request POST \
  --url 'https://api.scrapecreators.com/v1/facebook/adLibrary/search/ads' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api_token>' \
  --data '{
  "query": "running",
  "sort_by": "total_impressions",
  "search_type": "keyword_unordered",
  "ad_type": "all",
  "country": "ALL",
  "language": "EN",
  "status": "ACTIVE",
  "media_type": "ALL",
  "start_date": "2025-01-05",
  "end_date": "2025-02-16",
  "trim": false,
  "cursor": "AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"
}'
{
  "success": true,
  "credits_remaining": 1000000,
  "credits_charged": 1,
  "searchResults": [
    {
      "ad_archive_id": "615470338018648",
      "ad_id": null,
      "archive_types": [],
      "categories": [
        "UNKNOWN"
      ],
      "collation_count": 1,
      "collation_id": "888075953335279",
      "contains_digital_created_media": false,
      "contains_sensitive_content": false,
      "currency": "",
      "end_date": 1740729600,
      "entity_type": "PERSON_PROFILE",
      "fev_info": null,
      "finserv_ad_data": {
        "is_deemed_finserv": false,
        "is_limited_delivery": false
      },
      "gated_type": "ELIGIBLE",
      "has_user_reported": false,
      "hidden_safety_data": false,
      "hide_data_status": "NONE",
      "impressions_with_index": {
        "impressions_text": null,
        "impressions_index": -1
      },
      "is_aaa_eligible": false,
      "is_active": true,
      "is_profile_page": false,
      "menu_items": [],
      "page_id": "115531458627129",
      "page_is_deleted": false,
      "page_name": "JNB Stables Labradoodles",
      "political_countries": [],
      "publisher_platform": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "reach_estimate": null,
      "regional_regulation_data": {
        "finserv": {
          "is_deemed_finserv": false,
          "is_limited_delivery": false
        },
        "tw_anti_scam": {
          "is_limited_delivery": false
        }
      },
      "report_count": null,
      "snapshot": {
        "body": {
          "text": "Discover the unmatched joy of having Cedar in your life—a playful and intelligent labradoodle who’s eager to please and full of enthusiasm! Cedar boasts a confident demeanor and a moderate energy level, making him the perfect companion for any active household. His inquisitive nature and exceptional problem-solving skills will keep you entertained as he explores the world around him, ensuring that there’s never a dull moment.

Cedar’s independent spirit also presents a fantastic opportunity for bonding through obedience training. This experience not only strengthens your connection but also enhances his impressive skills—after all, with evaluation scores mostly in the 4's, Cedar shows remarkable potential for dog sports, hiking, running, and any stimulating activity you can think of!

Ideal for an experienced dog family ready to embrace an active lifestyle, Cedar is more than just a pet; he’s a loyal companion waiting to share exciting adventures with you. Don’t let the chance to welcome this incredible pup into your home slip away. By choosing Cedar, you’re opening the door to a lifetime of joy, love, and unforgettable experiences. Make Cedar a cherished member of your family today!"
        },
        "branded_content": null,
        "brazil_tax_id": null,
        "byline": null,
        "caption": null,
        "cards": [],
        "cta_text": "No button",
        "cta_type": "NO_BUTTON",
        "country_iso_code": null,
        "current_page_name": "JNB Stables Labradoodles",
        "disclaimer_label": null,
        "display_format": "MULTI_IMAGES",
        "event": null,
        "images": [
          {
            "original_image_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/481661162_990940825757018_8913176685534608816_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeFh8i-Z5kuJ16lqUxcUXs-ZDyrJuz4iKPUPKsm7PiIo9dMNkqCaPt8liPPGabEi8-gibi-WZTylOSlQQNRnxjTT&_nc_ohc=J_6SeTivTasQ7kNvgGEJ5D5&_nc_oc=AdiVcqOuQdywnrpvb75866Udx7xPfkUDT6ikNbmuIxTvcXWDy5hLn81fSf4M1zJD54w&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AZxpM4HubQsLPUC0gB46zAp&oh=00_AYD2APYZJejn4srpHfr9dWiivmYDVF3BBE4GZ39fhKpe_w&oe=67C83B69",
            "resized_image_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/480837265_659371736650913_3605385323286208049_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeHtmv91qbrhP_gBGdhH1sIeg9xKoAkcVGWD3EqgCRxUZel-aAIRonjSGXPj6LnUtMqdlcaX06Jz1tg8m_xMxpYD&_nc_ohc=tlfzH5L3yjgQ7kNvgFePtMF&_nc_oc=AdgiUmZhlwcNdDCj2UOoaF5i-kcJMbSk27A3C50uA6moXJvGdAk5AWivF7jBFDan8PE&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AZxpM4HubQsLPUC0gB46zAp&oh=00_AYB0_2vXVBDY6wjCOSCYm9xKKAIIzPW8lPuhHTUwpBCsXg&oe=67C84C71",
            "watermarked_resized_image_url": "",
            "image_crops": []
          },
          {
            "original_image_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/481038231_1533584647309311_8225992803054299716_n.jpg?_nc_cat=104&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeEk48U-ggbJVecRRom9upWrbwPaFVVtxVJvA9oVVW3FUkZoTmosNIlqCws7ikIwxTLzWzuguBE-lGwUTA0wSQhv&_nc_ohc=Q4yuGm3oU_sQ7kNvgEs7U_8&_nc_oc=Adita4blTpdRVqMULeWXTutl0t48b9P7rQLYt-rEkODOUoI8tGrOx5SG_4Od8hl6gBE&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AZxpM4HubQsLPUC0gB46zAp&oh=00_AYA2SZef7jhVsb0ftzLe8IslP8JXBaBWIz--B7mBAGUXXw&oe=67C8468F",
            "resized_image_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/480984651_1901120184038676_3525416492527391090_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeF6cqWvjNfWWNYRnrnXRJ1jlw7pErdLc0qXDukSt0tzSuZIrJlUX9rpiLo4GbrlQt1ELeeMA-4V2-nX9spVJk0z&_nc_ohc=bJrX5LjtSX4Q7kNvgFFZe7h&_nc_oc=AdjlZHoW7ejFM_Q8wH2GVy4LXh2tC6M1p93Y0RcICzZmhA-ptrWxFoWha6sluCwcyDw&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AZxpM4HubQsLPUC0gB46zAp&oh=00_AYBn9-TIlzBweSWTynunrOqusbSXVTnHpq_Q59emD_bRpg&oe=67C82ED3",
            "watermarked_resized_image_url": "",
            "image_crops": []
          }
        ],
        "is_reshared": false,
        "link_description": null,
        "link_url": null,
        "page_categories": [
          "Pet Service"
        ],
        "page_entity_type": "PERSON_PROFILE",
        "page_id": "115531458627129",
        "page_is_deleted": false,
        "page_is_profile_page": false,
        "page_like_count": 3823,
        "page_name": "JNB Stables Labradoodles",
        "page_profile_picture_url": "https://scontent.ford4-1.fna.fbcdn.net/v/t39.35426-6/481168271_2343627956022656_4475842746106730961_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_eui2=AeE5xuNZ8fz9pPPsJ7v7aD7en3tT5Wuv_kWfe1Pla6_-RXLb66aiQh3AfhlYqBQFisu5C4F-3Qy-BGnOVz1LzY-y&_nc_ohc=GDBS2WaBig8Q7kNvgFfDxKG&_nc_oc=AdiQjedPz36I9ZxzwBa-EwmwZ-KsV2YjJQGq3LDBYAJCg4BIeweEFvOL6nb_LS8rhKo&_nc_zt=14&_nc_ht=scontent.ford4-1.fna&_nc_gid=AZxpM4HubQsLPUC0gB46zAp&oh=00_AYB_cfoKnM_tT8JJQpLyNCTlP0af4KDJlXp6_zJb88ZC_A&oe=67C83A50",
        "page_profile_uri": "https://www.facebook.com/JNBStables/",
        "root_reshared_post": null,
        "title": null,
        "videos": [],
        "additional_info": null,
        "ec_certificates": [],
        "extra_images": [],
        "extra_links": [],
        "extra_texts": [],
        "extra_videos": []
      },
      "spend": null,
      "start_date": 1740729600,
      "state_media_run_label": null,
      "targeted_or_reached_countries": [],
      "total_active_time": 5519
    }
  ],
  "searchResultsCount": 50001,
  "cursor": "AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-"
}

Headers

x-api-key
string
required

Your Scrape Creators API key

Body Parameters

query
string
required

Keyword to search for

Example:
running
sort_by
string

Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions.

Example:
total_impressions
Available options:
total_impressions,
relevancy_monthly_grouped
search_type
string

Choose exact-phrase or keyword matching.

Example:
keyword_unordered
Available options:
keyword_unordered,
keyword_exact_phrase
ad_type
string

Search for all ads or only political and issue ads

Example:
all
Available options:
all,
political_and_issue_ads
country
string

One two-letter country code, or ALL (default).

Example:
ALL
language
string

Language to filter ads on. Needs to be a 2 letter language code, such as EN, ES, or FR.

Example:
EN
status
string

Status of the ad. Defaults to ACTIVE.

Example:
ACTIVE
Available options:
ALL,
ACTIVE,
INACTIVE
media_type
string

Ad media type. Defaults to ALL. Meme means an image with text.

Example:
ALL
Available options:
ALL,
IMAGE,
VIDEO,
MEME,
IMAGE_AND_MEME,
NONE
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
trim
boolean

Set true for a trimmed response.

Example:
false
cursor
string

Cursor to paginate through results

Example:
AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-

Response Field Explanations

collation_id
This is Facebook's internal ID for related ads in a campaign
collation_count
The number of ads in the campaign
is_active
Whether the ad is currently running
ad_archive_id
The *actual* ad id