Douyindouyin.xingtu.creators.rates.get

Douyin Xingtu creator rate card API

What a Douyin creator charges on Xingtu for each kind of sponsored work (integrated video, custom video and more), in yuan, whether each is open and how it is settled.

GEThttps://api.okdata.online/v1/douyin/xingtu/creators/rates/get

Price

One call costs $0.04 and returns one creator_rate. 1,000 lookups cost $40.00. Failed calls are not charged.

Parameters

Name	Type	Description
`id` *required	string	Xingtu creator ID (digits), from the Xingtu creator search; not the Douyin account ID. e.g. `7283826197740388415`
`view`	stringcompactstandardfull	How much of each object comes back. full adds platform-specific fields under ext. default `standard`
`fields`	string	Comma-separated fields to keep, to save tokens.

cursor, view and fields work the same on every endpoint: how requests work.

Returned fields

The item is a CreatorRate.

Field	Type	Description
`creator_id`	string	The marketplace creator ID.
`url`	string	The creator's page on the marketplace.
`rates`	Rate[]	Every offering on the rate card.
`industries`	string[] \| null	Industries the marketplace files the creator under.
`ext`	object	Platform-specific extras. Only returned with view=full.

Request

cURL

curl -G "https://api.okdata.online/v1/douyin/xingtu/creators/rates/get" \
  -H "Authorization: Bearer $OKDATA_API_KEY" \
  --data-urlencode 'id=7283826197740388415'

Python

import os
import requests

resp = requests.get(
    "https://api.okdata.online/v1/douyin/xingtu/creators/rates/get",
    headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"},
    params={"id": "7283826197740388415"},
    timeout=60,
)
body = resp.json()
if body["code"] != "ok":
    raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})")

row = body["data"]["item"]
print([(r["name"], r["price"], r["currency"]) for r in row["rates"]])
print("cost: $" + body["meta"]["billing"]["amount"])

TypeScript

const url = new URL('https://api.okdata.online/v1/douyin/xingtu/creators/rates/get');
url.searchParams.set('id', "7283826197740388415");

const res = await fetch(url, {
  headers: {
    Authorization: `Bearer ${process.env.OKDATA_API_KEY}`,
  },
});
const body = await res.json();
if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`);

const row = body.data.item;
console.log(row.rates.map((r) => `${r.name}: ${r.price} ${r.currency}`));
console.log('cost: $' + body.meta.billing.amount);

MCPtools/call

{
  "name": "call",
  "arguments": {
    "endpoint": "douyin.xingtu.creators.rates.get",
    "params": {
      "id": "7283826197740388415"
    }
  }
}

Or ask an agent that has the MCP server connectedUse Douyin Xingtu creator rate card and tell me what each kind of sponsored post costs with this creator.

Response

200 · application/jsonmeta.billing.amount = 0.04

{
  "code": "ok",
  "request_id": "0f6c2a8e-4b1d-4e0a-9a51-3c7d2b9e1f20",
  "data": {
    "item": {
      "creator_id": "7283826197740388415",
      "url": "https://www.xingtu.cn/ad/creator/author-homepage/douyin-video/7283826197740388415",
      "rates": [
        {
          "type": "integrated_video",
          "name": "植入视频",
          "price": 6800,
          "currency": "CNY",
          "available": true,
          "settlement": "固定价格"
        }
      ],
      "industries": [
        "3C及电器-其他3C及电器"
      ]
    }
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.rates.get",
    "billing": {
      "amount": "0.04",
      "currency": "USD",
      "balance_after": "9.96"
    },
    "unavailable": {},
    "cached": false,
    "replayed": false,
    "fetched_at": "2026-11-11T08:00:00Z"
  }
}

Try it

This sends a real call to https://api.okdata.online and is billed as usual: at most $0.04. Failed calls are free. Your key goes only to that address and is never stored on this site.

Questions

How much does the Douyin Xingtu creator rate card API cost?

One call costs $0.04 and returns one creator_rate. 1,000 lookups cost $40.00. Failed calls are not charged.

Do I need a Douyin account, cookies or a QR login?

No. You send only your okdata API key. The data is public data from Douyin; nothing is fetched with your own Douyin account.

Am I charged when a call fails?

No. Every error response says charged: false, except a timeout, which says charged: null until the outcome is known. Resend with the same Idempotency-Key and you are never charged twice.

What if Douyin does not show a field?

The field is null, and meta.unavailable names it with the reason: platform (the platform never shows it) or capability (we cannot fetch it yet).

Answers that use this endpoint

All Douyin endpoints → · Answers