# 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.

Canonical page: https://okdata.online/apis/douyin/xingtu/creators/rates/get/

- **Endpoint**: `GET /v1/douyin/xingtu/creators/rates/get`
- **ID**: `douyin.xingtu.creators.rates.get`
- **Price**: $0.04 per call
- **Returns**: one CreatorRate object (`data.item`)
- **Status**: beta
- **Good for**: Creator discovery

## 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 | Required | Default | Description |
|---|---|---|---|---|
| `id` | string | yes |  | Xingtu creator ID (digits), from the Xingtu creator search; not the Douyin account ID. (e.g. `7283826197740388415`) |
| `view` | string: compact / standard / full | no | `standard` | How much of each object comes back. full adds platform-specific fields under ext. |
| `fields` | string | no |  | Comma-separated fields to keep, to save tokens. |

cursor, view and fields work as described in [Requests](https://okdata.online/docs/requests/).

## Returned fields

Each item is a [CreatorRate](https://okdata.online/docs/objects/creator_rate/).

| 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 examples

### cURL

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

### Python

```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

```ts
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);
```

### MCP

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

Or ask an agent that has the MCP server connected:

> Use Douyin Xingtu creator rate card and tell me what each kind of sponsored post costs with this creator.

## Response example

```json
{
  "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"
  }
}
```

## Errors

Errors share one shape and are never charged, except a timeout, whose charge is unknown until looked up. The full table: https://okdata.online/docs/errors/

## 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).

## More Douyin endpoints

- [Douyin video search](https://okdata.online/apis/douyin/videos/search/): $0.02 per call · about 20 videos per page
- [Douyin video detail](https://okdata.online/apis/douyin/videos/get/): $0.002 per call
- [Douyin video comments](https://okdata.online/apis/douyin/videos/comments/list/): $0.002 per call · about 20 comments per page
- [Douyin account profile](https://okdata.online/apis/douyin/users/get/): $0.002 per call
- [Douyin account videos](https://okdata.online/apis/douyin/users/videos/list/): $0.002 per call · about 20 videos per page
- [Douyin hot search board](https://okdata.online/apis/douyin/trends/list/): $0.002 per call · about 50 board entries per page
- [Douyin Xingtu creator search](https://okdata.online/apis/douyin/xingtu/creators/search/): $0.004 per call · about 20 creators per page

## Answers that use this endpoint

- [Can an AI agent shortlist Xiaohongshu or Douyin creators for a campaign?](https://okdata.online/answers/ai-agent-creator-shortlist/): Yes, if it has marketplace and content tools: the agent searches PGY (蒲公英) or Xingtu with your follower band, which returns each creator's rates in yuan and median reads or views, then reads their recent notes to judge fit and ranks them against your brief. A Xiaohongshu shortlist from 3 PGY searches, recent notes for 40 creators and full PGY profiles for 20 finalists costs about $1.72.
- [How do I shortlist creators by follower range and price on Douyin and Xiaohongshu?](https://okdata.online/answers/creator-shortlist-followers-price/): Search the two official creator marketplaces with a follower range: Xingtu for Douyin and PGY (蒲公英) for Xiaohongshu both return each creator's rates in yuan, so you drop everyone over budget and rank the rest by price per thousand median views. A page of 20 creators costs $0.004 on Xingtu and $0.04 on PGY; 200 candidates from each cost $0.44.
- [How do I check Douyin Xingtu creator rates in bulk?](https://okdata.online/answers/xingtu-creator-rates-bulk/): Search each creator on Xingtu by name, which already returns their integrated and custom video rates in yuan, for $0.004 a search, then pull the full rate card of the ones you shortlist for $0.04 each. Pricing 60 creators both ways costs $2.64.