API reference

LIVE

One TikTok LIVE room: who is watching now, what it sold, and how the broadcast performed.

7 routes
1 credit per call
Base URL https://api.tokconnect.com/v1

One TikTok LIVE

One LIVE room (id = room id from live_search or live_top_selling). Live: now (title, creator, live or ended, viewers, Shop selling). Shop Analytics, any market via region: sales (revenue, units, duration), history, products (products sold), strategy (price bands), top_categories, stream_urls. Example: {"id":"7695846289116416799","method":"products"}.

GET/v1/lives/{id}

Live status, viewers, likes, Shop selling

1 credit per call

Parameters

idstringPathRequired
LIVE room id.

1 more optional parameter

detailstring
compact (default) returns the useful fields; full adds the raw upstream payload (large).
Defaultcompact One ofcompactfull

Use it in Claude or ChatGPT

Connect https://mcp.tokconnect.com/mcp and your AI calls this as the live tool with method: now. Same data, same credit. MCP setup

MCP tool call

{
  "tool": "live",
  "arguments": {
    "method": "now",
    "id": "7702601891041020685"
  }
}

Request

curl "https://api.tokconnect.com/v1/lives/7702601891041020685" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/lives/7702601891041020685",
    headers={"X-API-Key": os.environ["TOKCONNECT_API_KEY"]},
    timeout=100,
)
r.raise_for_status()
body = r.json()
print(body["data"])

const res = await fetch("https://api.tokconnect.com/v1/lives/7702601891041020685", {
  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();

Response

Example response

{
  "data": {
    "creator": {
      "handle": "nnnnylsoj",
      "id": "6959222640256353285",
      "nickname": "💋Jos💋",
      "secUid": "MS4wLjABAAAAutZIjs8mDE0LgnvabgKchstKgD6108hgzz94dnD6Smy5YBp6Y-fbOz7rZ0eThp4Q"
    },
    "likes": 9898,
    "live": true,
    "roomId": "7702601891041020685",
    "started": "2026-10-30T23:10:19Z",
    "title": "Doing mi makeup",
    "totalViewers": 8213,
    "url": "https://www.tiktok.com/@nnnnylsoj/live",
    "viewers": 1428
  },
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 7906,
    "request_id": "req_3f9c2a1b7d4e"
  }
}

Response fields

dataobjectThe tool's result. Compact by default; pass detail=full for the complete record.
data.creatorobject
data.creator.handlestring
data.creator.idstring
data.creator.nicknamestring
data.creator.secUidstring
data.likesinteger
data.liveboolean
data.roomIdstring
data.startedstring
data.titlestring
data.totalViewersinteger
data.urlstring
data.viewersinteger
metaobject
meta.credits_chargedinteger1 on success.
meta.credits_remainingintegerCredits left this period, when known.
meta.request_idstringQuote it to support.
next_cursorstringPresent when there is another page: pass it back as cursor.

Errors

400
401
402
403
404
429
502
503

Try it Live call, 1 credit

GET/v1/lives/{id}/history

Performance over the broadcast

1 credit per call
Shop Analytics
Paged
17 markets

Parameters

idstringPathRequired
LIVE room id.

7 more optional parameters

cursorstring
Paging: pass the next value from the previous response unchanged. Omit on the first page.
detailstring
compact (default) returns the useful fields; full adds the raw upstream payload (large).
Defaultcompact One ofcompactfull
endstring
Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).
limitinteger
Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.
regionstring
Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.
startstring
Shop Analytics methods: custom range start, YYYY-MM-DD.
windowstring
Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.
One of7d30d90d180d365d

Use it in Claude or ChatGPT

Connect https://mcp.tokconnect.com/mcp and your AI calls this as the live tool with method: history. Same data, same credit. MCP setup

MCP tool call

{
  "tool": "live",
  "arguments": {
    "method": "history",
    "id": "7699061230417349407"
  }
}

Request

curl "https://api.tokconnect.com/v1/lives/7699061230417349407/history" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/lives/7699061230417349407/history",
    headers={"X-API-Key": os.environ["TOKCONNECT_API_KEY"]},
    timeout=100,
)
r.raise_for_status()
body = r.json()
print(body["data"])

const res = await fetch("https://api.tokconnect.com/v1/lives/7699061230417349407/history", {
  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();

Response

Example response

{
  "data": {
    "currency": "USD",
    "dataEnd": "2026-10-28",
    "history": [
      {
        "duration": "0",
        "finish_time": "1792579235",
        "revenue": "0.0",
        "total_user": "6621",
        "total_user_incre": "0",
        "viewer_num": "350"
      },
      {
        "duration": "0",
        "finish_time": "1792579538",
        "revenue": "86.8559709094514",
        "total_user": "8144",
        "total_user_incre": "1523",
        "viewer_num": "410"
      },
      {
        "duration": "0",
        "finish_time": "1792579835",
        "revenue": "82.69281537669372",
        "total_user": "9594",
        "total_user_incre": "1450",
        "viewer_num": "438"
      }
    ],
    "id": "7699061230417349407",
    "market": "US",
    "notes": [
      "Market US (United States): amounts are in USD."
    ],
    "source": "TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.",
    "window": {
      "days": 30,
      "end": "2026-10-28",
      "start": "2026-09-29"
    }
  },
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 7906,
    "request_id": "req_3f9c2a1b7d4e"
  }
}

Response fields

dataobjectThe tool's result. Compact by default; pass detail=full for the complete record.
data.currencystring
data.dataEndstring
data.historyarray
data.history[].durationstring
data.history[].finish_timestring
data.history[].revenuestring
data.history[].total_userstring
data.history[].total_user_increstring
data.history[].viewer_numstring
data.idstring
data.marketstring
data.notesarray
data.sourcestring
data.windowobject
data.window.daysinteger
data.window.endstring
data.window.startstring
metaobject
meta.credits_chargedinteger1 on success.
meta.credits_remainingintegerCredits left this period, when known.
meta.request_idstringQuote it to support.
next_cursorstringPresent when there is another page: pass it back as cursor.

Errors

400
401
402
403
404
429
502
503

Try it Live call, 1 credit

GET/v1/lives/{id}/products

Products sold in the LIVE, with revenue

1 credit per call
Shop Analytics
Paged
17 markets

Parameters

idstringPathRequired
LIVE room id.
limitinteger
Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.

6 more optional parameters

cursorstring
Paging: pass the next value from the previous response unchanged. Omit on the first page.
detailstring
compact (default) returns the useful fields; full adds the raw upstream payload (large).
Defaultcompact One ofcompactfull
endstring
Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).
regionstring
Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.
startstring
Shop Analytics methods: custom range start, YYYY-MM-DD.
windowstring
Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.
One of7d30d90d180d365d

Use it in Claude or ChatGPT

Connect https://mcp.tokconnect.com/mcp and your AI calls this as the live tool with method: products. Same data, same credit. MCP setup

MCP tool call

{
  "tool": "live",
  "arguments": {
    "method": "products",
    "id": "7702601891041020685",
    "limit": 3
  }
}

Request

curl "https://api.tokconnect.com/v1/lives/7702601891041020685/products?limit=3" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/lives/7702601891041020685/products",
    params={
        "limit": 3,
    },
    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({
  limit: "3",
});
const res = await fetch(`https://api.tokconnect.com/v1/lives/7702601891041020685/products?${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();

Response

Example response

{
  "data": {
    "count": 0,
    "currency": "USD",
    "dataEnd": "2026-10-28",
    "hasMore": false,
    "id": "7702601891041020685",
    "items": [],
    "market": "US",
    "notes": [
      "Market US (United States): amounts are in USD."
    ],
    "source": "TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.",
    "window": {
      "days": 30,
      "end": "2026-10-28",
      "start": "2026-09-29"
    }
  },
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 7906,
    "request_id": "req_3f9c2a1b7d4e"
  }
}

Response fields

dataobjectThe tool's result. Compact by default; pass detail=full for the complete record.
data.countinteger
data.currencystring
data.dataEndstring
data.hasMoreboolean
data.idstring
data.itemsarray
data.marketstring
data.notesarray
data.sourcestring
data.windowobject
data.window.daysinteger
data.window.endstring
data.window.startstring
metaobject
meta.credits_chargedinteger1 on success.
meta.credits_remainingintegerCredits left this period, when known.
meta.request_idstringQuote it to support.
next_cursorstringPresent when there is another page: pass it back as cursor.

Errors

400
401
402
403
404
429
502
503

Try it Live call, 1 credit

GET/v1/lives/{id}/sales

Revenue, units, duration, viewers

1 credit per call
Shop Analytics
Paged
17 markets

Parameters

idstringPathRequired
LIVE room id.

7 more optional parameters

cursorstring
Paging: pass the next value from the previous response unchanged. Omit on the first page.
detailstring
compact (default) returns the useful fields; full adds the raw upstream payload (large).
Defaultcompact One ofcompactfull
endstring
Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).
limitinteger
Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.
regionstring
Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.
startstring
Shop Analytics methods: custom range start, YYYY-MM-DD.
windowstring
Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.
One of7d30d90d180d365d

Use it in Claude or ChatGPT

Connect https://mcp.tokconnect.com/mcp and your AI calls this as the live tool with method: sales. Same data, same credit. MCP setup

MCP tool call

{
  "tool": "live",
  "arguments": {
    "method": "sales",
    "id": "7699061230417349407"
  }
}

Request

curl "https://api.tokconnect.com/v1/lives/7699061230417349407/sales" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/lives/7699061230417349407/sales",
    headers={"X-API-Key": os.environ["TOKCONNECT_API_KEY"]},
    timeout=100,
)
r.raise_for_status()
body = r.json()
print(body["data"])

const res = await fetch("https://api.tokconnect.com/v1/lives/7699061230417349407/sales", {
  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();

Response

Example response

{
  "data": {
    "currency": "USD",
    "dataEnd": "2026-10-28",
    "id": "7699061230417349407",
    "market": "US",
    "notes": [
      "Market US (United States): amounts are in USD."
    ],
    "source": "TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.",
    "totals": {
      "id": "7699061230417349407",
      "revenue": "$174.88k",
      "sale": "5.87k",
      "unit_price": "$29.81",
      "viewer_num": "435",
      "views": "3.09m"
    },
    "window": {
      "days": 30,
      "end": "2026-10-28",
      "start": "2026-09-29"
    }
  },
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 7906,
    "request_id": "req_3f9c2a1b7d4e"
  }
}

Response fields

dataobjectThe tool's result. Compact by default; pass detail=full for the complete record.
data.currencystring
data.dataEndstring
data.idstring
data.marketstring
data.notesarray
data.sourcestring
data.totalsobject
data.totals.idstring
data.totals.revenuestring
data.totals.salestring
data.totals.unit_pricestring
data.totals.viewer_numstring
data.totals.viewsstring
data.windowobject
data.window.daysinteger
data.window.endstring
data.window.startstring
metaobject
meta.credits_chargedinteger1 on success.
meta.credits_remainingintegerCredits left this period, when known.
meta.request_idstringQuote it to support.
next_cursorstringPresent when there is another page: pass it back as cursor.

Errors

400
401
402
403
404
429
502
503

Try it Live call, 1 credit

GET/v1/lives/{id}/strategy

Price bands of what was sold

1 credit per call
Shop Analytics
Paged
17 markets

Parameters

idstringPathRequired
LIVE room id.

7 more optional parameters

cursorstring
Paging: pass the next value from the previous response unchanged. Omit on the first page.
detailstring
compact (default) returns the useful fields; full adds the raw upstream payload (large).
Defaultcompact One ofcompactfull
endstring
Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).
limitinteger
Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.
regionstring
Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.
startstring
Shop Analytics methods: custom range start, YYYY-MM-DD.
windowstring
Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.
One of7d30d90d180d365d

Use it in Claude or ChatGPT

Connect https://mcp.tokconnect.com/mcp and your AI calls this as the live tool with method: strategy. Same data, same credit. MCP setup

MCP tool call

{
  "tool": "live",
  "arguments": {
    "method": "strategy",
    "id": "7699061230417349407"
  }
}

Request

curl "https://api.tokconnect.com/v1/lives/7699061230417349407/strategy" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/lives/7699061230417349407/strategy",
    headers={"X-API-Key": os.environ["TOKCONNECT_API_KEY"]},
    timeout=100,
)
r.raise_for_status()
body = r.json()
print(body["data"])

const res = await fetch("https://api.tokconnect.com/v1/lives/7699061230417349407/strategy", {
  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();

Response

Example response

{
  "data": {
    "currency": "USD",
    "dataEnd": "2026-10-28",
    "id": "7699061230417349407",
    "market": "US",
    "notes": [
      "Market US (United States): amounts are in USD."
    ],
    "pricing": [
      {
        "cate_id": "Others",
        "id": "-1",
        "percentage": "100",
        "revenue": "$174.88k"
      },
      {
        "cate_id": "Beauty & Personal Care",
        "id": "601450",
        "percentage": 92,
        "revenue": "$161.70k"
      },
      {
        "cate_id": "Home Supplies",
        "id": "600001",
        "percentage": 0,
        "revenue": "$0.00"
      }
    ],
    "source": "TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.",
    "window": {
      "days": 30,
      "end": "2026-10-28",
      "start": "2026-09-29"
    }
  },
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 7906,
    "request_id": "req_3f9c2a1b7d4e"
  }
}

Response fields

dataobjectThe tool's result. Compact by default; pass detail=full for the complete record.
data.currencystring
data.dataEndstring
data.idstring
data.marketstring
data.notesarray
data.pricingarray
data.pricing[].cate_idstring
data.pricing[].idstring
data.pricing[].percentagestring
data.pricing[].revenuestring
data.sourcestring
data.windowobject
data.window.daysinteger
data.window.endstring
data.window.startstring
metaobject
meta.credits_chargedinteger1 on success.
meta.credits_remainingintegerCredits left this period, when known.
meta.request_idstringQuote it to support.
next_cursorstringPresent when there is another page: pass it back as cursor.

Errors

400
401
402
403
404
429
502
503

Try it Live call, 1 credit

GET/v1/lives/{id}/stream-urls

Recording and stream URLs

1 credit per call
Shop Analytics
Paged
17 markets

Parameters

idstringPathRequired
LIVE room id.
limitinteger
Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.

6 more optional parameters

cursorstring
Paging: pass the next value from the previous response unchanged. Omit on the first page.
detailstring
compact (default) returns the useful fields; full adds the raw upstream payload (large).
Defaultcompact One ofcompactfull
endstring
Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).
regionstring
Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.
startstring
Shop Analytics methods: custom range start, YYYY-MM-DD.
windowstring
Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.
One of7d30d90d180d365d

Use it in Claude or ChatGPT

Connect https://mcp.tokconnect.com/mcp and your AI calls this as the live tool with method: stream_urls. Same data, same credit. MCP setup

MCP tool call

{
  "tool": "live",
  "arguments": {
    "method": "stream_urls",
    "id": "7702601891041020685",
    "limit": 3
  }
}

Request

curl "https://api.tokconnect.com/v1/lives/7702601891041020685/stream-urls?limit=3" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/lives/7702601891041020685/stream-urls",
    params={
        "limit": 3,
    },
    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({
  limit: "3",
});
const res = await fetch(`https://api.tokconnect.com/v1/lives/7702601891041020685/stream-urls?${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();

Response

Example response

{
  "data": {
    "currency": "USD",
    "dataEnd": "2026-10-28",
    "id": "7702601891041020685",
    "market": "US",
    "notes": [
      "Market US (United States): amounts are in USD."
    ],
    "source": "TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.",
    "urls": {
      "is_purchase": false,
      "record_type": "SHORT",
      "screenshotUrl": "https://live.kalocdn.com/live/7702601891041020685/screenshot.png?key=a9ffb57e94ceee0ef3dd1256efc3fff5&time=1793403315359",
      "shortUrl": "https://live.kalocdn.com/live_short/7702601891041020685.mp4?key=0606d33370508acbececc338c091d39a&time=1793403315373"
    },
    "window": {
      "days": 30,
      "end": "2026-10-28",
      "start": "2026-09-29"
    }
  },
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 7906,
    "request_id": "req_3f9c2a1b7d4e"
  }
}

Response fields

dataobjectThe tool's result. Compact by default; pass detail=full for the complete record.
data.currencystring
data.dataEndstring
data.idstring
data.marketstring
data.notesarray
data.sourcestring
data.urlsobject
data.urls.is_purchaseboolean
data.urls.record_typestring
data.urls.screenshotUrlstring
data.urls.shortUrlstring
data.windowobject
data.window.daysinteger
data.window.endstring
data.window.startstring
metaobject
meta.credits_chargedinteger1 on success.
meta.credits_remainingintegerCredits left this period, when known.
meta.request_idstringQuote it to support.
next_cursorstringPresent when there is another page: pass it back as cursor.

Errors

400
401
402
403
404
429
502
503

Try it Live call, 1 credit

GET/v1/lives/{id}/top-categories

Top categories sold

1 credit per call
Shop Analytics
Paged
17 markets

Parameters

idstringPathRequired
LIVE room id.

7 more optional parameters

cursorstring
Paging: pass the next value from the previous response unchanged. Omit on the first page.
detailstring
compact (default) returns the useful fields; full adds the raw upstream payload (large).
Defaultcompact One ofcompactfull
endstring
Shop Analytics methods: custom range end, YYYY-MM-DD (capped at the last complete day).
limitinteger
Results per page. Shop Analytics methods max 100. Values above a method's maximum are lowered and reported in notes.
regionstring
Market as an ISO country code, default US. Shop Analytics methods: sales data for that market, amounts in its currency. Live methods that take it (search, video detail, creator posts, Shop pages): TikTok as seen in that market where TikTok serves it. Core: US, GB, DE, FR, ES, JP, TH, VN, ID, MY, PH, BR, MX. Extended: PL, IT, NL, IE. Other countries are refused. See shop_regions.
startstring
Shop Analytics methods: custom range start, YYYY-MM-DD.
windowstring
Shop Analytics methods: date range ending at the last complete day (about 2 days ago). Default 30d. Use start/end for a custom range.
One of7d30d90d180d365d

Use it in Claude or ChatGPT

Connect https://mcp.tokconnect.com/mcp and your AI calls this as the live tool with method: top_categories. Same data, same credit. MCP setup

MCP tool call

{
  "tool": "live",
  "arguments": {
    "method": "top_categories",
    "id": "7699061230417349407"
  }
}

Request

curl "https://api.tokconnect.com/v1/lives/7699061230417349407/top-categories" \
  -H "X-API-Key: $TOKCONNECT_API_KEY"

import os
import requests

r = requests.get(
    "https://api.tokconnect.com/v1/lives/7699061230417349407/top-categories",
    headers={"X-API-Key": os.environ["TOKCONNECT_API_KEY"]},
    timeout=100,
)
r.raise_for_status()
body = r.json()
print(body["data"])

const res = await fetch("https://api.tokconnect.com/v1/lives/7699061230417349407/top-categories", {
  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();

Response

Example response

{
  "data": {
    "categories": {
      "topCates": [
        {
          "cate_id": "Beauty & Personal Care",
          "id": "601450",
          "revenue": 5030
        }
      ]
    },
    "currency": "USD",
    "dataEnd": "2026-10-28",
    "id": "7699061230417349407",
    "market": "US",
    "notes": [
      "Market US (United States): amounts are in USD."
    ],
    "source": "TokConnect Shop Analytics (TikTok Shop US). Revenue and units are estimates: units track TikTok's sold counter; revenue is units times listed price.",
    "window": {
      "days": 30,
      "end": "2026-10-28",
      "start": "2026-09-29"
    }
  },
  "meta": {
    "credits_charged": 1,
    "credits_remaining": 7906,
    "request_id": "req_3f9c2a1b7d4e"
  }
}

Response fields

dataobjectThe tool's result. Compact by default; pass detail=full for the complete record.
data.categoriesobject
data.categories.topCatesarray
data.categories.topCates[].cate_idstring
data.categories.topCates[].idstring
data.categories.topCates[].revenueinteger
data.currencystring
data.dataEndstring
data.idstring
data.marketstring
data.notesarray
data.sourcestring
data.windowobject
data.window.daysinteger
data.window.endstring
data.window.startstring
metaobject
meta.credits_chargedinteger1 on success.
meta.credits_remainingintegerCredits left this period, when known.
meta.request_idstringQuote it to support.
next_cursorstringPresent when there is another page: pass it back as cursor.

Errors

400
401
402
403
404
429
502
503

Try it Live call, 1 credit