FeedMCP

Data APIs / TikTok

TikTok ad search API

Search TikTok's public Ads Library (ads shown in Europe) by keyword or advertiser: advertiser, copy, video, first and last shown, reach range, 12 a page.

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

TikTok's public Ads Library only covers ads shown in Europe (EU plus GB, CH, NO and TR), not the US or Asia. Search results usually lack the advertiser ID; use the ad endpoint for it.

Parameters

Name Type Required Description
keyword string one of Search keyword
advertiser string one of Advertiser name
country string no Only ads delivered to this country: a two-letter European code (or GB, TR, CH, NO), such as DE or FR
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/tiktok/ads/search?keyword=camping" \
  -H "Authorization: Bearer $FEEDMCP_API_KEY"

Python

import os, requests

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

JavaScript

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

MCP

From an AI with FeedMCP installed, the call tool:

{
  "endpoint": "tiktok.ads.search",
  "params": {
    "keyword": "camping"
  },
  "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": "1881016343088211",
        "platform": "tiktok",
        "url": "https://library.tiktok.com/ads/detail/?ad_id=1881016343088211",
        "advertiser": {
          "id": null,
          "name": "Trail Outfitters GmbH"
        },
        "format": "video",
        "headline": null,
        "text": "Winter camping gear sale 1",
        "cta": null,
        "landing_url": null,
        "images": [
          "https://p16-common-sign.tiktokcdn.com/cover.jpeg"
        ],
        "videos": [
          "https://library.tiktok.com/api/v1/cdn/mock/video"
        ],
        "first_shown": "2026-11-05T00:00:00.000Z",
        "last_shown": "2026-11-06T00:00:00.000Z",
        "active": null,
        "placements": [],
        "countries": [],
        "impressions": {
          "min": 10000,
          "max": 100000
        },
        "paid_by": null
      },
      {
        "id": "1881016343088212",
        "platform": "tiktok",
        "url": "https://library.tiktok.com/ads/detail/?ad_id=1881016343088212",
        "advertiser": {
          "id": null,
          "name": "Trail Outfitters GmbH"
        },
        "format": "video",
        "headline": null,
        "text": "Winter camping gear sale 2",
        "cta": null,
        "landing_url": null,
        "images": [
          "https://p16-common-sign.tiktokcdn.com/cover.jpeg"
        ],
        "videos": [
          "https://library.tiktok.com/api/v1/cdn/mock/video"
        ],
        "first_shown": "2026-11-05T00:00:00.000Z",
        "last_shown": "2026-11-06T00:00:00.000Z",
        "active": null,
        "placements": [],
        "countries": [],
        "impressions": {
          "min": 10000,
          "max": 100000
        },
        "paid_by": null
      }
    ]
  },
  "page": {
    "next_cursor": "eyJjdXJzb3IiOjIwfQ",
    "has_more": true
  },
  "warnings": [],
  "meta": {
    "endpoint": "tiktok.ads.search",
    "platform": "tiktok",
    "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 TikTok endpoints

Questions

How much does the TikTok 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.

A video ID is the number after /video/ in a video link; an account is the username after @ (without the @); a TikTok Shop product is the number after /pdp/, a shop is shop.id in a product.

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 tiktok.ads.search.