A TikTok data API for developers and AI agent builders
TikTok data API for developers: what's winning, in your own code.
Everything people search, watch, say and buy on TikTok, as clean JSON from one connection. Use it inside ChatGPT, Claude, Cursor or your own code, and skip the scraper: the top TikTok Shop US product made an estimated $1.54M in six days, and one call shows who sold it.
No key yet? Try it in the research agent, or connect ChatGPT, Claude or Cursor in a minute.
$ claude mcp add --transport http tokconnect https://mcp.tokconnect.com/mcp
# then /mcp to sign in, or add --header "Authorization: Bearer $KEY"
> # search TikTok videos {"keyword": "mechanical keyboard", "limit": 5}
{ "hasMore": true,
"next": { "offset": 5, "search_id": "2026100806…C049" },
"videos": [ …,
{ "id": "7646481737324743949",
"views": 2200000, "saves": 4578,
"products": [ { "id": "1729920316907491647" } ] }, … ] }- Endpoint
https://mcp.tokconnect.com/mcp- Protocol
- MCP over HTTP
- Auth
- OAuth sign-in or Bearer key
- Markets
- 17 TikTok Shop markets
- Tools
- 34, covering 137 research endpoints in 13 groups, from search demand to Shop sales
- REST API
- On every paid plan, same key. API docs
- Limits
- 1 credit per lookup, failed lookups free. Free: 50 credits, 60 requests a minute, 2 at once.
Sheet 02 · Schematic
What people search, what sells and who wins, behind one endpoint
Your agent sees one server. Every answer comes back as compact JSON with stable ids you can pass from one call to the next.
Fig. 1: research endpoints per group
137 endpoints in 13 groups, behind 34 tools
16ways to read what people search on TikTok
It is the data a scraper can't reach. Creator Search Insights lives in the TikTok app behind a login, and TokConnect returns it as JSON, with how many videos answer each search.
17TikTok Shop markets with sales estimates
Estimated revenue and units for products, shops, brands, creators, videos, LIVEs and categories, with daily trends. The live US Shop adds listings, prices, stock and reviews.
Sheet 02b · Shop Analytics
What's selling: TikTok Shop sales estimates as JSON
Rank TikTok Shop products, shops, brands, creators, videos and LIVEs by estimated revenue and units, in 17 markets. The top US product of 13 to 18 October 2026, a medicube body care set, made $1.54M from 49,559 units, sold by 2,729 creators.
{
"dataEnd": "2026-10-18",
"market": "US",
"window": { "days": 6, "start": "2026-10-13", "end": "2026-10-18" },
"items": [
{ "id": "1732052189676081387",
"product_title": "[medicube] Smooth & Clear Body Care Set …",
"revenue": "$1.54m", "sale": 49559,
"video_revenue": "$1.49m", "live_revenue": "$45.72k",
"commission_rate": "13%", "creator_num": 2729,
"launch_date": "2025-11-18" }, … ] }- Estimated revenue and units.
revenueandsaleare sales estimates for the window, in the market and currency the response names (marketisUShere), split intovideo_revenue,live_revenueand showcase. - Dated. Every response names its
window,dataEnd(the last complete day),marketand, where it holds amounts,currency. - Ids that join. Pass a row's
idback to get its daily trend, its creators or the videos that sold it. - Filters. Keyword, category, market, price, growth, commission, creator count and launch date.
Real response from 20 October 2026, trimmed. Source: TikTok Shop US sales estimates via TokConnect. Full JSON
Sheet 03 · Detail
Who's winning: the videos, creators and products behind them
One video search for "mechanical keyboard" returned a 2,200,000-view video and the Shop listing it sells. These two real responses from 8 October 2026 show what you build around: paging, plain numbers and ids that join.
{
"hasMore": true,1
"next": {2
"offset": 5,
"search_id": "202610080602529CA14AA6C39604D5C049"
},
"videos": [
… 3 earlier videos …
{
"id": "7646481737324743949",
"caption": "OFFICIAL AULA F75 Pro Creamy Mechanical Tri-Mode Keyboard …",
"views": 2200000,3
"likes": 12600,
"saves": 4578,
"shares": 2130,
"comments": 294,
"durationSec": 32,
"posted": "2026-06-01T17:34:51Z",
"isAd": true,4
"creator": { "handle": "•••••", "followers": 31400 },
"products": [5
{ "id": "1729920316907491647", "name": "OFFICIAL AULA F75 Pro" }
]
},
… 1 more video …
]
}hasMoresays another page exists. Count pages, not items: TikTok filters after ranking, so a page can come back short whilehasMorestays true.nextholds the arguments for page two. Spread it into your next call as it came. Here that meansoffsetandsearch_id; Shop search usespage_token, topic search onlyoffset.- Counts are plain integers, read from TikTok at call time. This video had 2,200,000 views and 4,578 saves when we called.
isAdis TikTok's own flag on the post, passed through. Posts without the flag leave the field out, so test whether it exists rather than for null.products[].idis a TikTok Shop product id. It is the join key into the Shop data below.
{
"page": "search",
"hasMore": true,
"next": {6
"offset": 30,
"page_token": "202610080602561A87F14F45B5E9107A79"
},
"products": [
… 4 earlier listings …
{
"id": "1729920316907491647",7
"shop": "Aula",
"price": 76.07,
"originalPrice": 97.52,
"discount": "22%",
"currency": "USD",
"sold": 9570,8
"rating": 4.8,
"reviews": 1237
},
… 20 more listings …
],
"relatedSearches": [ { "name": "mechanical keyboard switches", … }, … ]
}- Same paging rule, different keys. Pass back whatever
nextholds. You never build a cursor yourself. - The join. The product id from note 5 is the fifth listing in Shop search: Aula, $76.07, 4.8 stars from 1,237 reviews. With those two responses, your agent has the video and the listing it sells.
soldis the count TikTok displays on the listing, a running total of units, ready to rank listings against each other.
Fig. 2: one call, 25 listings, price vs displayed units sold
Shop search "mechanical keyboard", TikTok Shop US, 8 Oct 2026
Sheet 04 · Wiring
Setup details: connect in one line
Every client points at the same URL. Sign in with OAuth when the client supports it, or send a key as Authorization: Bearer. Create a key on the API key page.
Calling it from code instead? The REST API docs cover every route, and TokConnect for TikTok Shop developers shows the Shop data.
REST API on every paid plan, same key:
curl "https://api.tokconnect.com/v1/products/top?keyword=lip%20oil®ion=US" \
-H "X-API-Key: $TOKCONNECT_API_KEY"# OAuth: add the server, then type /mcp in a session and sign in
claude mcp add --transport http tokconnect https://mcp.tokconnect.com/mcp
# Or a key, sent as a Bearer header
claude mcp add --transport http tokconnect https://mcp.tokconnect.com/mcp \
--header "Authorization: Bearer YOUR_TOKCONNECT_KEY"Then claude mcp list should show tokconnect as connected. Full Claude Code guide
// ~/.cursor/mcp.json
{
"mcpServers": {
"tokconnect": {
"url": "https://mcp.tokconnect.com/mcp",
"headers": {
"Authorization": "Bearer ${env:TOKCONNECT_TOKEN}"
}
}
}
}Export TOKCONNECT_TOKEN before you launch Cursor. Full Cursor guide
# ~/.codex/config.toml
[mcp_servers.tokconnect]
url = "https://mcp.tokconnect.com/mcp"
bearer_token_env_var = "TOKCONNECT_TOKEN"
enabled = true
# or sign in instead: drop the bearer line, then
codex mcp login tokconnectRun codex mcp list to check. Full Codex guide
Sheet 05 · Alternatives
Scrape it yourself, or call it
One URL replaces a scraping stack, and it returns the search demand and Shop sales a scraper can't reach.
Do it yourself
Call it
| Row | Open-source scraper | Hosted scraper | TokConnect MCP server |
|---|---|---|---|
| Example | davidteather/TikTok-Api, an unofficial Python wrapper, MIT licence | Apify TikTok Scraper | One URL |
| You run | Playwright, an ms_token from your tiktok.com cookies, and per its README "you may need a proxy" | A job, then you download the dataset | Nothing. Calls go over MCP from any client |
| Price | Free, plus your servers and proxies | From $1.70 per 1,000 results; some features charged per event | Start free with 50 credits, no card. Paid plans start at $34.99 a month, billed yearly |
| TikTok search volume | Creator Search Insights sits behind a TikTok login with no export or API, so a scraper of public pages doesn't reach it | 7-day search popularity, daily trend and video counts | |
| When TikTok changes | You patch it | The vendor patches it | TokConnect patches it |
Checked 8 October 2026 on each project's own page.
For every official and unofficial route, see the TikTok API guide; for what breaks in a self-hosted scraper, the scraper guide. Building on Shop data? See the TikTok Shop API guide, and TikTok API pricing for what each route costs.
Building a consumer-demand dataset? TikTok as alternative data shows dated brand search curves you can pull through the API.
Key statistics
TokConnect serves TikTok search demand, TikTok Shop sales estimates and public TikTok content from one MCP endpoint, https://mcp.tokconnect.com/mcp.
The top TikTok Shop US product of 13 to 18 October 2026, a medicube body care set, made an estimated $1.54M from 49,559 units, sold by 2,729 creators.
One TikTok Shop US search for "mechanical keyboard" on 8 October 2026 returned 25 listings priced $14.79 to $168.99, with a median of 1,381 displayed units sold.
Sheet 06 · Notes
Questions developers ask
Is there a TikTok API that returns search volume?
Yes: TokConnect. TikTok's search volumes live in Creator Search Insights, in the TikTok app and at tiktok.com/csi, which has no export or API of its own. TokConnect returns those figures as JSON: 7-day search popularity, the daily trend and how many videos TikTok lists for each search.
How do I page through results?
List responses return the hasMore and next fields. Pass the fields inside next back on your next call, exactly as they came. Stop when hasMore is false.
What does detail=full do?
Every TokConnect response is compact by default: the fields most people use, with stable ids. Add "detail": "full" and TikTok's raw payload comes back as well.
Do I need a TikTok account to use it?
No. TokConnect needs only a TokConnect sign-in or key. It reads public TikTok data and never posts, schedules or logs in to anyone's TikTok account, so there is nothing to connect on the TikTok side.
What TikTok Shop data can I get through an API?
Both sides of TikTok Shop. TokConnect reads the live US shop: listings, price, stock, reviews and storefronts. It also returns estimated revenue and units for products, shops, brands, creators, videos, LIVEs and categories in 17 markets. The top US product of 13 to 18 October 2026 showed an estimated $1.54M from 49,559 units.
What are the limits?
One credit per lookup, and failed lookups are free. Free includes 50 credits, 60 requests a minute and 2 requests at once; paid plans raise all three. The full table is on credits and limits.
How much does TokConnect cost for a developer?
Start free with 50 credits, no card. Paid plans start at $34.99 a month, billed yearly, and the REST API is on every paid plan.
New to MCP? Read the TikTok MCP guide.
How we got these numbers: TikTok Shop US sales estimates via TokConnect, pulled 20 October 2026 (Shop), and TikTok video and Shop search responses from 8 October 2026 (videos, Shop search). Creator handles are masked. Outside prices were checked on each project's page on 8 October 2026 (facts).
