# Facebook Ad Library Keyword Search

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

by ScrapeCreators Ready 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 →](https://scrollport.com/tools/meta-ad-library-api)

- [Facebook ad library company ads by page id or name](https://scrollport.com/tools/providers/scrapecreators/v1-facebook-adlibrary-company-ads) ScrapeCreators $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_type` string · optional

enum: all, political_and_issue_ads

`country` string · optional

Country used to filter or localise the results.

`cursor` string · optional

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

minLength: 1 · maxLength: 16384

`end_date` string · optional

format: date

`language` string · optional

`media_type` string · optional

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

`query` string · required

Search terms used to find relevant records.

minLength: 1 · maxLength: 200

`search_type` string · optional

Kind of search to run.

enum: keyword_unordered, keyword_exact_phrase

`sort_by` string · optional

enum: total_impressions, relevancy_monthly_grouped

`start_date` string · optional

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

format: date

`status` string · optional

enum: ALL, ACTIVE, INACTIVE

### Output

`items` array

Result records.

`retrieved_at` string

When the data was retrieved.

`total_results` number

**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"}

---

Canonical page: https://scrollport.com/tools/providers/scrapecreators/facebook-ad-library-keyword-search