FeedMCP

Data APIs / Meta Ad Library

Meta ad search API

Search the Meta Ad Library (Facebook, Instagram and Meta's other apps) by keyword: advertiser, copy, images and videos, landing page, run dates and placements, 30 a page.

Item Value
Endpoint GET https://api.feedmcp.com/v1/meta/ads/search
ID meta.ads.search
Price $0.002 / call
Returns A page of Ad objects
Auth Authorization: Bearer $FEEDMCP_API_KEY

Cursors last about an hour; after that, start again from the first page (an expired cursor errors, free of charge). Later pages may hold fewer than 30 because duplicates are removed. For dynamic product ads (format dpa) the headline and images come from the first product.

Parameters

Name Type Required Description
keyword string yes Search keyword
country string no Only ads shown in this country, as a two-letter code such as US, GB or DE; leave it out for all countries
status active / inactive / all no active, inactive or all; default active
media all / image / video no Creative type: all, image or video; default all
sort impressions / newest no impressions (high to low) or newest; default impressions
cursor string no Pagination cursor. Leave it out for the first page; pass page.next_cursor for the next. Each page is billed on its own

Every endpoint also takes view=full to include the platform's raw data as raw, at the same price.

Returned fields

data.items is a list of Ad objects, with the same fields on every platform:

Field Type Description
id string Ad ID, which the library's ad endpoint takes: the library ID on Meta, "AR…/CR…" on Google, a number on LinkedIn and TikTok
platform string Library: meta, google, linkedin or tiktok
url string | null Link to the ad in the library
advertiser.id string | null Advertiser ID: the Facebook page ID on Meta, the AR… ID on Google; pass it to that library's advertiser ads
advertiser.name string | null Advertiser name
format string | null Format, such as image, video, text, dpa (dynamic product ads) or Carousel Ad
headline string | null Headline
text string | null Body copy
cta string | null Call-to-action text, such as Shop now
landing_url string | null Landing page
images string[] Image URLs
videos string[] Video URLs
first_shown string | null First shown, ISO 8601, UTC
last_shown string | null Last shown (today for ads still running)
active boolean | null Still running (Meta only)
placements string[] Placements (Meta only): facebook, instagram, messenger, threads or audience_network
countries string[] Countries shown in, two-letter codes (when the library publishes them)
impressions {min, max} | null Impression range (when the library publishes it; reach range on TikTok)
paid_by string | null Who paid (LinkedIn, and political ads on Meta)

When you are charged

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Each answer carries meta.billing: what this call cost and the balance left.

Request

cURL

curl "https://api.feedmcp.com/v1/meta/ads/search?keyword=camping+tent" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

r = requests.get(
    "https://api.feedmcp.com/v1/meta/ads/search",
    params={"keyword": "camping tent"},
    headers={"Authorization": f"Bearer {os.environ['FEEDMCP_API_KEY']}"},
    timeout=30,
)
print(r.json())

JavaScript

const res = await fetch("https://api.feedmcp.com/v1/meta/ads/search?keyword=camping+tent", {
  headers: { Authorization: `Bearer ${process.env.FEEDMCP_API_KEY}` },
});
console.log(await res.json());

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "meta.ads.search",
  "params": {
    "keyword": "camping tent"
  },
  "max_price": "0.002"
}

Response

The data below is made up; the shape is the real one.

{
  "code": "ok",
  "request_id": "req_7Qm2kXb9TzLp",
  "data": {
    "items": [
      {
        "id": "1193112469566051",
        "platform": "meta",
        "url": "https://www.facebook.com/ads/library/?id=1193112469566051",
        "advertiser": {
          "id": "22437985072",
          "name": "Trail Outfitters",
          "avatar": "https://scontent.xx.fbcdn.net/a.jpg",
          "url": "https://www.facebook.com/trailoutfitters/"
        },
        "format": "image",
        "headline": "Winter tents, 20% off 1",
        "text": "Stay warm on the trail this winter.",
        "cta": "Shop now",
        "landing_url": "https://example.com/tents",
        "images": [
          "https://scontent.xx.fbcdn.net/ad.jpg"
        ],
        "videos": [],
        "first_shown": "2025-10-19T21:06:40.000Z",
        "last_shown": "2025-11-18T21:06:40.000Z",
        "active": true,
        "placements": [
          "facebook",
          "instagram"
        ],
        "countries": [],
        "impressions": null,
        "paid_by": null
      },
      {
        "id": "1193112469566052",
        "platform": "meta",
        "url": "https://www.facebook.com/ads/library/?id=1193112469566052",
        "advertiser": {
          "id": "22437985072",
          "name": "Trail Outfitters",
          "avatar": "https://scontent.xx.fbcdn.net/a.jpg",
          "url": "https://www.facebook.com/trailoutfitters/"
        },
        "format": "image",
        "headline": "Winter tents, 20% off 2",
        "text": "Stay warm on the trail this winter.",
        "cta": "Shop now",
        "landing_url": "https://example.com/tents",
        "images": [
          "https://scontent.xx.fbcdn.net/ad.jpg"
        ],
        "videos": [],
        "first_shown": "2025-10-19T21:06:40.000Z",
        "last_shown": "2025-11-18T21:06:40.000Z",
        "active": true,
        "placements": [
          "facebook",
          "instagram"
        ],
        "countries": [],
        "impressions": null,
        "paid_by": null
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "meta.ads.search",
    "platform": "meta",
    "fetched_at": "2026-11-19T08:00:00.000Z",
    "source": "FeedMCP",
    "catalog_revision": "d09a736bd39e8b3f",
    "billing": {
      "charged": true,
      "amount": "0.002",
      "currency": "USD",
      "balance": "9.98"
    }
  }
}

Errors are described in Errors: each says whether you were charged (charged) and whether to retry (retry).

Other Meta Ad Library endpoints

Questions

How much does the Meta ad search endpoint cost?

$0.002 per successful call, including an empty result (an empty search is still an answer). Bad parameters, platform errors and timeouts are free.

Do I need a platform account?

No. Only public data is read.

An ad is the number after id= in a library link; an advertiser is its Facebook page ID (advertiser.id in an ad, or use the advertiser search).

How do I get more items?

When the answer has page.next_cursor, pass it back as cursor for the next page. Each page is billed on its own.

How do I use it from an AI?

Install the MCP server and ask; your AI calls meta.ads.search.