SocialToAIStart freeConsole
POST/v1/call/douyin.kol_ratesPreview

Douyin KOL rate card API (Xingtu)

Only on Douyin.

The Douyin KOL rate card API (Xingtu) returns what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled. One call costs 24 credits ($0.048 to $0.08 depending on the pack); failed calls are free. Call it over HTTP or from your AI client over MCP. Last tested 2026-10-17.

Start for freeSign in to run
100 credits on sign-up, no card needed
24 creditsper call
One objectreturned per call
2026-10-17last tested
856 Bsample response, 1 item

Last updated:

Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

Request and response

curl https://api.socialtoai.com/v1/call/douyin.kol_rates \  -H "Authorization: Bearer $SOCIALTOAI_KEY" \  -H "Content-Type: application/json" \  -d '{    "id": "6629656444889202692"  }'
import osimport requestsresponse = requests.post(    "https://api.socialtoai.com/v1/call/douyin.kol_rates",    headers={"Authorization": f"Bearer {os.environ['SOCIALTOAI_KEY']}"},    json={        "id": "6629656444889202692",    },)print(response.json())
# Connected over MCP? Ask in plain words.Use the Douyin Xingtu creator rate card interface (douyin.kol_rates) with id: 6629656444889202692.# Your AI calls the call tool with:{  "id": "6629656444889202692"}
Sign in to run24 creditsOpens in the Playground with these parameters after you sign in. It never runs by itself.
200 OK856 B24 credits
{  "op": "douyin.kol_rates",  "platform": "douyin",  "status": "ok",  "items": [    {      "platform": "douyin",      "id": "…",      "ref": "…",      "approx": [],      "type": "entry",      "entry_type": "creator_rates",      "title": null,      "url": null,      "rank": null,      "heat": null,      "fields": {        "currency": "CNY",        "rates": [          {            "name": "植入视频",            "amount": "400000",            "settlement": "固定价格",            "open": true          },          {            "name": "定制视频",            "amount": "500000",            "settlement": "固定价格",            "open": true          }        ]      }    }  ],  "unavailable": [],  "cost_credits": 24}
entry_type
creator_rates
currency
CNY

Names and text were removed from the sample; the numbers are as recorded.

Sample dataFull response

1 parameter.
All required.

Send them as a JSON body with POST. Your key goes in the Authorization header, never in the URL.

NameTypeRequiredDefaultDescription
idstringRequired—Xingtu creator ID

Where to get what you send.

id

Xingtu creator ID (e.g. 6629656444889202692)

Every item these return carries its ref; send it as it is:

The fields of each item.
What Douyin cannot give is marked.

FieldTypeMeaning
items[].titlestringThe entry's title or name.
items[].urlstringA link that opens it; null where the platform's list has none.
items[].rankintegerPosition on a board, from 1.
items[].heatintegerThe platform's heat score.
items[].fields.currencystringThe currency of the amounts.
items[].fields.ratesarrayWhat the creator charges: name, amount, settlement and whether it is open.
nullFields Douyin cannot give

Douyin gives every field of this call. Where one item lacks a value, that field is null.

Every item also has platform, id, ref, approx and type; the response around the items is the same on every call. Response format

What to expect.

One call returns one object, with no pages, for 24 credits.
This call is slow: it answers 202 with a results handle first. Read the result with the handle once it is ready; reading is free and works for 24 hours.

1 call per second per key, 5 after a purchase; going over is not charged. Rate limits

A failed call costs 0 credits and is never retried on its own. Error codes

Once connected over MCP, these questions use it.

  1. Get what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled: 6629656444889202692.
    call {"op":"douyin.kol_rates","id":"6629656444889202692"}
    24 credits
  2. Search Douyin creators on Xingtu by words in their name: 美食, then for the first 3: get what a Douyin creator charges on Xingtu for each kind of sponsored work, and how it is settled.
    call {"op":"douyin.kol_search","query":"美食"}call {"op":"douyin.kol_rates","id":"<ref>"} × 3
    75 credits

Questions.
Short answers.

Everything on Douyin
Do I need a Douyin account or Douyin's own API access?
No. You only need a SocialToAI key. The call returns content and account information publicly visible on Douyin; you never sign in to Douyin or apply for anything there.
What does “Preview” mean here?
Preview: this interface is not marked stable yet, so its parameters and fields may still change. It is charged like any other call, and a failed call is not charged.

Your AI is one URL away
from all of social media.

Start for freeDocs

100 credits on sign-up, no card needed