TikHub logo

TikHub API · Social

Get Douyin ranking list data with the TikHub API

Returns Douyin XingTu creator business ranking list data. You call it with one looot token, no TikHub account needed. It needs no required input. Each call costs $0.002 per call. It has fewer than 10 looot runs in the last 30 days, so no success rate is shown yet.

Price
$0.002 per call
Success rate, 30 days
not enough runs yet
Runs, 30 days
under 10
Access
looot token only

Get Douyin ranking list data: call it from code

One POST to /v1/runs with your looot token, the endpoint id tikhub-api-douyin-xingtu-v2-get-ranking-list-data and an input. Values come from the stored input schema; a value in <angle brackets> is a placeholder the schema gives no example for.

The stored input schema names no input to show.

POST /v1/runs

TikHub API request: curl
curl -X POST 'https://api.looot.ai/v1/runs?wait=true' \
  -H 'Authorization: Bearer YOUR_LOOOT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{"endpointId":"tikhub-api-douyin-xingtu-v2-get-ranking-list-data","input":{},"idempotencyKey":"<unique-idempotency-key>"}'

Response: expected shape, not yet checked

{ code, data: { info: { code, version, entry_type, description, modify_time, display_name, platform_channel, ranking_list_factor }, authors: unknown[], base_resp: { status_code, status_message }, pagination: { page, limit, has_more, total_count } }, docs, time, params: { code, date, period, version, qualifier }, router, message, support, cache_url, time_zone, message_zh, request_id, time_stamp, cache_message, cache_message_zh }

expected shape, not yet checked against real answers.

Price and reliability

Price formula
$0.0020 per call
Most one run can cost
$0.002
Success rate, 30 days
not enough runs yet
Runs, 30 days
not enough runs yet
Median answer time
not enough runs yet
Last success
not recorded

Run numbers are looot's own runs of each endpoint over the last 30 days: the share that completed without an error, and the median time to answer. An endpoint with fewer than 10 runs in that window shows "not enough runs to rank" and is never ranked. Prices are what looot charges per call or per result, fee included, read from the live catalog; you prepay credit and each call is charged when it runs.

More TikHub endpoints

Questions about the TikHub API on looot

Returns Douyin XingTu creator business ranking list data. Optional inputs: code, date, period, version, qualifier. Qualifier can be obtained from get_ranking_list_catalog API. looot stores its output format, not yet checked on real answers.

It costs $0.002 per call. Price formula: $0.0020 per call. You keep a prepaid balance. The price is shown before each call runs, and you are charged only for calls that actually ran.

Send POST https://api.looot.ai/v1/runs with your looot token in the Authorization header and a body with endpointId "tikhub-api-douyin-xingtu-v2-get-ranking-list-data" and an input object. The looot CLI runs it with looot run tikhub-api-douyin-xingtu-v2-get-ranking-list-data, and the looot MCP server with its run tool.

Whether a miss costs money depends on the provider. Some bill only for found values. Some bill every call. A failed call costs nothing. You can request a refund of the unused part of the balance you paid for at any time.

Give your agent every data provider, one key.

Everyone gets $2 in free credits once after sign-in and workspace selection. Then pay only for what you use.