Facebook Ad Library Keyword Search

Search public Meta ads across advertisers by keyword, country and media type.

by ScrapeCreatorsReady to run$0.0027 per request · $0.27 per 100 requests

Example

You ask your agent

“Find active video ads about running shoes in the US.”

You get

First of 25,523 results

Page name: KURU Footwear
Start time: 2026-07-06 07:00 UTC
End time: 2026-10-25 07:00 UTC
URL: https://www.facebook.com/ads/library/?id=1339489931715040
Is active: Yes
Platforms: FACEBOOK, INSTAGRAM, AUDIENCE_NETWORK
Creative title: Get Comfort in the Chaos
Creative text: You saw the apocalypse. The zombies were scary. Now meet the shoes that make foot pain the real casualty. 🦶Built for…

What your agent sends and gets back (JSON)

Your agent works out the exact inputs, such as IDs, dates and settings, from what you ask.

Request

{
  "tool_id": "scrapecreators.facebook-ad-library-keyword-search",
  "input": {
    "query": "running shoes",
    "status": "ACTIVE",
    "country": "US",
    "media_type": "VIDEO"
  }
}

Response

{
  "items": [
    {
      "id": "1339489931715040",
      "url": "https://www.facebook.com/ads/library/?id=1339489931715040",
      "page_id": "71740214065",
      "creative": {
        "text": "You saw the apocalypse. The zombies were scary. Now meet the shoes that make foot pain the real casualty. \n🦶Built for Heel Pain Relief \n🌟50,000+ 5-Star Reviews \n📦Free Shipping \n👟91-Day Returns & Exchanges",
        "title": "Get Comfort in the Chaos",
        "link_url": "https://www.kurufootwear.com/pages/outbreak",
        "call_to_action": "Shop now"
      },
      "end_time": 1792911600,
      "is_active": true,
      "page_name": "KURU Footwear",
      "platforms": [
        "FACEBOOK",
        "INSTAGRAM",
        "AUDIENCE_NETWORK"
      ],
      "start_time": 1783321200
    },
    {
      "id": "1747158169634497",
      "url": "https://www.facebook.com/ads/library/?id=1747158169634497",
      "page_id": "71740214065",
      "creative": {
        "text": "You saw the apocalypse. The zombies were scary. Now meet the shoes that make foot pain the real casualty. \n🦶Built for Heel Pain Relief \n🌟50,000+ 5-Star Reviews \n📦Free Shipping \n👟91-Day Returns & Exchanges",
        "title": "Foot Pain Got Left for Dead",
        "link_url": "https://www.kurufootwear.com/pages/outbreak",
        "call_to_action": "Shop now"
      },
      "end_time": 1792911600,
      "is_active": true,
      "page_name": "KURU Footwear",
      "platforms": [
        "FACEBOOK",
        "INSTAGRAM",
        "AUDIENCE_NETWORK"
      ],
      "start_time": 1784617200
    }
  ],
  "retrieved_at": "2026-10-25T14:00:36.794Z",
  "total_results": 25523
}

Use it with your agent

Copy the prompt and paste it into your agent, then tell it what you need.

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Facebook Ad Library Keyword Search (tool ID: scrapecreators.facebook-ad-library-keyword-search). Ask me for the details you need, then show me the result.

Provider access is included. If your agent isn't connected to Scrollport yet, it will help you set that up.

Other tools for this job

Compare all 2 →

Facebook ad library company ads by page id or nameScrapeCreators$0.0027 per request$0.0027 per request

Questions

Is Facebook Ad Library Keyword Search by ScrapeCreators free?

Scrollport has no free tier: it costs $0.0027 per request ($0.27 per 100 requests), paid per use from a prepaid wallet with no subscription. Connecting your first agent adds $1 of trial credit, so you can try it before adding funds.

Do I need an API key from ScrapeCreators?

No. Your agent runs it through your Scrollport connection (MCP, the Scrollport CLI or the HTTP API), and Scrollport handles access to ScrapeCreators, so you don't sign up with ScrapeCreators or manage an API key.

Details

About this tool

Search one Meta Ad Library page by keyword or exact phrase, with country, language, media, activity and date filters. Return advertiser identities, ad copy, creative links and the next cursor. Each page is one completed request, including an empty page. Media links can expire; commercial ads do not necessarily disclose spend or impressions. Failed requests are uncharged.

All inputs and outputs

Input

ad_typestring · optional

enum: all, political_and_issue_ads

countrystring · optional

Country used to filter or localise the results.

cursorstring · optional

Exact next_cursor from the preceding page; keep the same filters.

minLength: 1 · maxLength: 16384

end_datestring · optional

format: date

languagestring · optional

media_typestring · optional

enum: ALL, IMAGE, VIDEO, MEME, IMAGE_AND_MEME, NONE

querystring · required

Search terms used to find relevant records.

minLength: 1 · maxLength: 200

search_typestring · optional

Kind of search to run.

enum: keyword_unordered, keyword_exact_phrase

sort_bystring · optional

enum: total_impressions, relevancy_monthly_grouped

start_datestring · optional

Impressions start date, YYYY-MM-DD; must not exceed end_date.

format: date

statusstring · optional

enum: ALL, ACTIVE, INACTIVE

Output

itemsarray

Result records.

retrieved_atstring

When the data was retrieved.

total_resultsnumber

Errors and limits

invalid_input: The route input was invalid or outside its public-read bounds.example: {"query":"running shoes","country":"US","status":"ACTIVE","media_type":"VIDEO"}