Guide
Quickstart
From key to first response in about a minute. You need a TokConnect Pro or Enterprise plan.
Get your key
Open your TokConnect account and copy your API key. The same key works for the REST API and the MCP server.
Keep it in an environment variable
export TOKCONNECT_API_KEY="paste-your-key-here"Your code reads it from there, so the key never sits in a file you might commit.
Make the call
This ranks TikTok Shop US products that match "lip oil" by revenue.
curl "https://api.tokconnect.com/v1/products/top?keyword=lip%20oil®ion=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();Read the response
The rows are under
data. Ifnext_cursoris there, pass it back ascursorfor the next page.meta.credits_chargedsays what the call cost.{ "data": { "...": "the tool's JSON" }, "next_cursor": "eyJwYWdlIjoyfQ", "meta": { "credits_charged": 1, "request_id": "req_…" } }Go further
Change the market with
region(17 markets), browse the rankings, or open any product, shop or creator by id. Every route page has a Try it console, so you can test a call before you write code.