# TikTok data API

The TokConnect API gives your code TikTok data: TikTok Shop sales, products, shops and creators in 17 markets, plus videos, comments, search demand, sounds and hashtags. Every route runs the same tool as the TokConnect MCP server, so anything your AI can look up, your code can too.

The REST API is on every paid plan. [Paid plans](https://tokconnect.com/pricing/) from $34.99 a month. Free includes every research tool and 50 credits, but not the REST API.

[Get an API key](https://app.tokconnect.com/api-key)[Try this data free in the research agent](https://app.tokconnect.com/?q=Top-selling%20lip%20oil%20products%20on%20TikTok%20Shop%20US)

- **Base URL:** `https://api.tokconnect.com/v1`
- **Auth:** `X-API-Key` header
- **Cost:** 1 credit per call
- **Plans:** [Paid plans from $34.99 a month](https://tokconnect.com/pricing/)

## Your first request

Rank the best-selling TikTok Shop products for a keyword. Put your key in `TOKCONNECT_API_KEY` and run:

```bash
curl "https://api.tokconnect.com/v1/products/top?keyword=lip%20oil&region=US" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"
```

```python
import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/products/top",
    params={
        "keyword": "lip oil",
        "region": "US",
    },
    headers={"X-API-Key": os.environ["TOKCONNECT_API_KEY"]},
    timeout=100,
)
r.raise_for_status()
body = r.json()
print(body["data"])
```

```javascript
const params = new URLSearchParams({
  keyword: "lip oil",
  region: "US",
});
const res = await fetch(`https://api.tokconnect.com/v1/products/top?${params}`, {
  headers: { "X-API-Key": process.env.TOKCONNECT_API_KEY },
});
if (!res.ok) throw new Error((await res.json()).error?.message);
const { data, next_cursor } = await res.json();
```

Every success comes back in the same envelope: the tool's JSON under `data`, `next_cursor` when there is another page, and `meta` with the credits charged.

200 OK:

```json
{
  "data": { "...": "the tool's JSON" },
  "next_cursor": "eyJwYWdlIjoyfQ",
  "meta": { "credits_charged": 1, "request_id": "req_…" }
}
```

New here? The [quickstart](https://tokconnect.com/docs/api/quickstart/) takes you from key to response in four steps. The full spec is at `GET /v1/openapi.json` (send your key).

## API reference

137 routes in 13 groups. Each one has parameters, code samples, the matching MCP tool and a console to try it.

- [**Rankings5 routes**The best-selling TikTok Shop products, shops and creators in any of 17 markets, ranked by revenue, units or growth, plus the top 10 videos and LIVEs.](https://tokconnect.com/docs/api/rankings/)
- [**Products18 routes**Everything about one TikTok Shop product: live price and stock, sales, daily trend, the creators and videos selling it, and what reviews say. Plus the store as shoppers see it now.](https://tokconnect.com/docs/api/products/)
- [**Shops10 routes**One TikTok Shop seller: its storefront, sales split by channel, daily trend, products, launches, affiliates and the videos that sell for it.](https://tokconnect.com/docs/api/shops/)
- [**Creators20 routes**A creator's public profile and posts, and their TikTok Shop business: what they sell, for which brands, and who follows them.](https://tokconnect.com/docs/api/creators/)
- [**Videos16 routes**One video or photo post: counts, comments, transcript, similar videos and the sales it drove. Plus samples of TikTok's own feeds and a fair comment giveaway draw.](https://tokconnect.com/docs/api/videos/)
- [**LIVE7 routes**One TikTok LIVE room: who is watching now, what it sold, and how the broadcast performed.](https://tokconnect.com/docs/api/live/)
- [**Search7 routes**Search TikTok the way the app answers right now: videos, photo posts, accounts, hashtags, LIVE rooms and places.](https://tokconnect.com/docs/api/search/)
- [**Demand and keywords16 routes**What people search for on TikTok, from TikTok's own Creator Search Insights, plus autocomplete and keyword ideas from TikTok and TikTok Shop.](https://tokconnect.com/docs/api/demand/)
- [**Categories5 routes**TikTok Shop categories ranked by revenue and growth, the category tree with ids, and a category's top products.](https://tokconnect.com/docs/api/categories/)
- [**Ads and Creative Center8 routes**TikTok's ads library and Creative Center: search ads by keyword, see where each ad ran and, when TikTok provides it, how viewers held on second by second, plus trending videos by market, SEO inspiration lists and Creative Partner agencies.](https://tokconnect.com/docs/api/creative-center/)
- [**Charts5 routes**TikTok's own leaderboards: the music charts, trending hashtags and searches, LIVE leaders and the top videos by market.](https://tokconnect.com/docs/api/charts/)
- [**Sounds, hashtags and places12 routes**Sounds, hashtags and tagged places, each with the videos that use it. Music marketers check a sound before they post; restaurants check the videos tagged at their address.](https://tokconnect.com/docs/api/sounds-hashtags-places/)
- [**Reference and markets8 routes**The 17 markets, and the lists other routes take values from: filters, category ids, channels, languages and LIVE gift prices.](https://tokconnect.com/docs/api/reference-lists/)

## Guides

- [**Quickstart**Key to first response in four steps, in curl, Python or JavaScript.](https://tokconnect.com/docs/api/quickstart/)
- [**Authentication**Send your key in one header. Where to find it and how to keep it safe.](https://tokconnect.com/docs/api/authentication/)
- [**Markets**The 17 TikTok Shop markets, their currencies, and the region parameter.](https://tokconnect.com/docs/api/markets/)
- [**Credits and limits**1 credit per call, failed calls never charged, and the per-plan rate limits.](https://tokconnect.com/docs/api/credits-and-limits/)
- [**Pagination**Walk long lists with next_cursor and cursor.](https://tokconnect.com/docs/api/pagination/)
- [**Errors**Every error code, what causes it and what to do.](https://tokconnect.com/docs/api/errors/)
- [**MCP**The same tools inside ChatGPT, Claude and Cursor.](https://tokconnect.com/docs/api/mcp/)
- [**CLI and Python**Every route as a terminal command or a Python method: npx tokconnect, pip install tokconnect.](https://tokconnect.com/docs/api/cli/)
- [**Changelog**Dated list of what changed in the API.](https://tokconnect.com/docs/api/changelog/)

---

Last updated 2 Nov 2026. Source: https://tokconnect.com/docs/api/  
All TokConnect API docs as one Markdown file: https://tokconnect.com/docs/api/llms-full.txt
