Top Ads search, ad details and performance
The Top Ads of TikTok's Creative Center: search the ads running on the list and read one ad with its performance figures.
GET /v1/tiktok/creative_center/ads/search$0.00202 endpoints · from $0.0020 →AdsE-commerce
TikTok API
Also known as抖音国际版抖音海外版
18 endpoints read TikTok: videos, hashtags, users, comments, ad library, Creative Center, TikTok Shop. From $0.0020 a call. No TikTok login and no cookie; a failed call is free.
Endpoints18 endpointsin 7 groups, one response shape
PriceFrom $0.0020per call. Failed calls are free
When an upstream failsRetried for youChecked every day with real calls · 4 days on record
DataFetched liveat the moment of the call
One call, as it came back
A recorded call, fields already tidied up: ready for an AI or a spreadsheet.GET/v1/tiktok/videos/search$0.0020
FieldValue
typevideo
langen
published_at2026-10-11 23:17 UTC
author.followers92,601
metrics.likes353
metrics.comments11
metrics.shares19
metrics.favorites40
The first 8 rows of a response recorded 2026-10-12 19:17 UTC.
Run it in the Playground · $0.0020Recorded response
{
"code": "ok",
"request_id": "eecdbf3f-64ce-4b11-b396-ee190d7ff728",
"data": {
"items": [
{
"id": "7566364515678793552",
"url": "https://www.tiktok.com/@trail_and_lens/video/7566364515678793552",
"type": "video",
"text": "My honest take on space station, a month in.",
"lang": "en",
"published_at": "2026-10-11T23:17:34.000Z",
"author": {
"id": "6279025233109159764",
"username": "trail_and_lens",
"name": "Maya Chen",
"avatar_url": "https://p16-sign-va.tiktokcdn.com/tos-maliva-avt-0068/fff322a0d982cccf1e82~c5_100x100.jpeg",
"followers": 92601
},
"metrics": {
"likes": 353,
"comments": 11,
"shares": 19,
"favorites": 40,
"views": 7561
},
"hashtags": [
"weekendvibes",
"gearreview",
// … 2 more
],
"mentions": []
},
// … 29 more
]
},
"page": {
"next_cursor": "c1.bGY_kn5Dxsgl6MN3VXHyMcLAdlxPxQw-FwjswIlE",
"cursor_expires_at": "2026-10-12T20:17:24.000Z",
"has_more": true,
"returned": 30
},
"warnings": [],
"meta": {
"capability": "tiktok.videos.search",
"result_status": "complete",
"fetched_at": "2026-10-12T19:17:24.000Z",
"cached": false,
"replayed": false,
"unavailable": {
"title": "platform",
"images": "capability",
"author.verified": "capability",
"metrics.reposts": "capability",
"mentions.username": "capability",
"mentions.name": "capability",
"post_id": "platform",
"parent_id": "platform",
"root_id": "platform",
"is_pinned": "capability"
},
"billing": {
"amount": "0.002",
"currency": "USD",
"balance_after": "9.998"
}
}
}From a response recorded 2026-10-12 19:17 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.
What you can get
Each row is an endpoint: what it returns and what one call costs.
EndpointPathReturnsPrice
Videos4
Hashtags1
Users4
Comments1
Ad library2
Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.TikTok API pricing →TikTok data in your AI →See live status →
Only on TikTok
Creative Center, TikTok Shop: data that sits behind TikTok's own dashboards and sign-ins. Here each is one GET.
TikTok Creative Center API →
TikTok Shop API →GET /v1/tiktok/shop/products/search$0.00204 endpoints · from $0.0020 →
Product search, product details, buyer reviews, seller catalogs
Public product data of TikTok Shop: product search, product details, buyer reviews and a seller's products.
TikTok Shop product detail$0.0020
TikTok Shop product reviews$0.0020
TikTok Shop product search$0.0020
TikTok Shop seller products$0.0020
What people build with it
Ready-made tasks your AI can run on TikTok data. Each is a few calls under a spending cap.
Word of mouth and comment insight
Comments and word of mouth
“What are people praising and complaining about under this post?”
TikTok video comments$0.0020
Example run: 3 calls, at most $0.0060
Competitor monitoringCompetitor account monitoring
“What did competitors post this week, and which post took off?”
TikTok user videos$0.0020
Example run: 2 calls, at most $0.0040
Word of mouth and comment insightKeyword search and mentions
“What is being said about this brand or keyword on each platform?”
TikTok video search$0.0020
Example run: 3 calls, at most $0.0240
Ask about TikTok right inside Claude or Cursor
Add the DataXAPI MCP server and the AI finds the TikTok endpoint it needs and calls it; answers link back to the source. You pay for the calls it makes.
https://api.dataxapi.com/mcpStart in three steps
The call shown here is TikTok video search. Every other TikTok endpoint is called the same way and answers in the same envelope.
Get a key
Sign in with an emailed code or Google. Free trial, no card needed.
Call it, or let your AI call it
One GET from your code. Or paste this prompt into your agent with your key in it: it sets itself up, then finds and calls these endpoints by itself.
Read https://dataxapi.com/agents.md and set up DataXAPI in this agent. My API key is dx_live_…; use it for every DataXAPI call.
Read the same shape every time
Items are in data.items (one object in data.item), the next page in page.next_cursor, the charge in meta.billing.amount. A failed call is not charged.
curl -G "https://api.dataxapi.com/v1/tiktok/videos/search" \ --data-urlencode "query=space station" \ -H "Authorization: Bearer $DATAXAPI_API_KEY"
from dataxapi import DataXAPI dx = DataXAPI() # reads DATAXAPI_API_KEY result = dx.tiktok.videos.search(query="space station") print(result["data"]["items"])
import { DataXAPI } from "@dataxapi/sdk";
const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.tiktok.videos.search({ query: "space station" });
console.log(result.data.items);dataxapi call tiktok.videos.search 'query=space station'{
"mcpServers": {
"dataxapi": {
"type": "http",
"url": "https://api.dataxapi.com/mcp",
"headers": {
"Authorization": "Bearer ${DATAXAPI_API_KEY}"
}
}
}
}Add this to your MCP client, then ask your agent to call tiktok.videos.search.
Edge cases
What the TikTok endpoints do at their edges, and what to check when a call does not return what you expected.
- Page sizes
- A list returns 10 to 60 items a page, depending on the endpoint. 10 of the 12 lists go on to a next page:
page.next_cursor, passed back ascursor, each page a call of its own. The others return one page only. - Fields it cannot give
- 16 of the 18 endpoints cannot fill every field of the object they return. Each endpoint's page lists which, and every answer repeats them in
meta.unavailable: a missing field is never a silent zero. - A missing object that reads as empty
- TikTok comment replies, TikTok video comments, TikTok Shop product reviews: an object that does not exist cannot be told from one with nothing under it, so the answer is an empty result, not a 404, and is charged as an empty result is.
- Preview structures
- 8 endpoints return a preview structure whose fields may still change; the others return a standard object, the same on every platform.
- Accounts by handle
- An account's videos and followers take the handle without the @; hashtag videos take the hashtag's name without the #.
- Long links only
- Video endpoints take the ID or the long link (tiktok.com/@<handle>/video/<id>); short links are not taken.
- Ads Library and Top Ads differ
- The Ads Library is the transparency record of ads shown in Europe. Top Ads is a showcase of ads that did well, one country at a time (the US when none is named), and has no dates.
- Shop: the US, first page
- Shop endpoints cover the United States. Product detail has no price; product search gives it. Search and reviews return their first page only, reviews the first 10.
- Not every video has a transcript
- A video without captions reads as not found and is not charged; a video ID nobody has reads the same.
Questions about the TikTok API
Short answers. The details are on each endpoint's page.
How is the TikTok API priced?
Per call, no subscription. All 18 endpoints cost $0.0020 a call. You are charged when data comes back; a failed call costs nothing.
Do I need a TikTok account or a cookie?
No. One DataXAPI key is all you hold: no TikTok login, no cookie, no device to keep alive. The endpoints return publicly visible data only.
Is the data live?
A call fetches from TikTok at that moment, and meta.fetched_at says when. A result is kept for 24 hours, so a retry with the same Idempotency-Key is not charged again.
Is an empty result charged?
A list that comes back empty is charged its price: the search was run. Reading one object that does not exist answers not_found and is free.
What happens when TikTok changes something?
A call that fails is not charged, whatever the reason. An endpoint that is paused answers capability_paused, also free, and GET /v1/catalog/status says what is up right now.
Related
Tools built on these endpoints
How-to guides and answers
Other platforms
YouTube10 endpointsInstagram8 endpointsX (Twitter)21 endpointsDouyin34 endpointsXiaohongshu (RedNote)21 endpointsReddit11 endpointsFacebook4 endpointsWeChat Official Accounts6 endpointsWeChat Channels7 endpointsWeChat Search1 endpointBilibili8 endpointsWeibo10 endpointsLinkedIn7 endpointsThreads4 endpointsKuaishou8 endpointsZhihu16 endpointsTelegram3 endpointsPinterest2 endpointsMeta Ad Library5 endpointsGoogle Ads3 endpointsAll 21 platforms →
Call TikTok with one key.
Free trial on sign-up: up to 50 calls at $0.0020. No card. No TikTok login, no cookie, no subscription. A failed call is free.