API documentation

TokConnect 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.

Base URL: https://api.tokconnect.com/v1
Auth: X-API-Key header
Cost: 1 credit per call
Plans: Pro and Enterprise

Your first request

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

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

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"])

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

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

New here? The quickstart takes you from key to response in about a minute. 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.

TokConnect API

Your first request

API reference

Guides