# Douyin Xingtu creator rate card API (douyin.xingtu_rate_card)

- Canonical page: https://everyinfra.com/en/douyin-api/xingtu_rate_card
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "douyin", "action": "xingtu_rate_card", "params": {...}}
- Price: $0.000556 per call ($0.56 per 1,000 requests); failed calls and empty results are not charged
- Returns: single object
- Mode: sync; add "mode": "async" for slow tasks

Douyin Xingtu creator rate card reads the quote tiers a creator publishes on Xingtu for brand collaborations, given the creator's `douyin_id`, the handle displayed on their Douyin profile. Each entry in `rate_tiers` describes one way to work together: the format, the current quote and the original quote, how the fee is settled, the video type it covers and whether the tier is open. Campaign planners rely on it to set budgets, compare creators of similar reach on price and see which formats a creator takes on.

Treat the tiers as the prices the creator displays, not as an agreed deal or a final settlement. Where the current quote sits below the original, the gap shows a discount on display. Take the `douyin_id` from Douyin Creator search or the profile, because Xingtu creator search results do not carry it. `creator_id` is Xingtu's own ID for the creator, separate from both the public profile ID and the Douyin ID you pass.

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=douyin&action=xingtu_rate_card

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| douyin_id | not declared | yes | not declared | The visible Douyin account ID (`unique_id`) returned by the ordinary `creator_search` action and required by `xingtu_creator_analytics` and `xingtu_rate_card`; `xingtu_creator_search` does not return it. It is distinct from a `user_id` (`secUid`), Xingtu `creator_id`, and nickname. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| creator_id | platform-native meaning |
| rate_tiers | platform-native meaning |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "douyin",
  "action": "xingtu_rate_card",
  "params": {
    "douyin_id": "XiaoZhenlla"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "douyin",
        "action": "xingtu_rate_card",
        "params": {
            "douyin_id": "XiaoZhenlla",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "douyin",
  "action": "xingtu_rate_card",
  "results": {
    "creator_id": "•••",
    "rate_tiers": [
      {
        "description": "植入视频",
        "price_cny": 1500,
        "list_price_cny": 1500,
        "settlement_terms": "固定价格",
        "video_type": 2,
        "is_open": true
      },
      {
        "description": "定制视频",
        "price_cny": 1800,
        "list_price_cny": 1800,
        "settlement_terms": "固定价格",
        "video_type": 71,
        "is_open": true
      },
      {
        "description": "抖音短视频合集任务",
        "price_cny": 550,
        "list_price_cny": 550,
        "settlement_terms": "固定价格",
        "video_type": 73,
        "is_open": true
      }
    ],
    "platform": "douyin"
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## FAQ

### Are the quotes in `rate_tiers` final prices?

No. They are the quotes Xingtu shows for each tier, not an agreed deal and not what is finally settled. Use them to plan budgets and compare creators, and treat the terms of a real booking as a separate agreement made when the deal is done.

### What does each tier contain?

A description of the collaboration format, the current quote, the original quote, a note on how the fee is settled, the video type the tier covers and whether it is open. Compare creators tier by tier on the same video type; mixing types can make one creator look cheaper than another.

### How do I weigh a quote against a creator's reach?

Read the same creator with the Douyin Xingtu creator analytics capability, using the same `douyin_id`; it returns follower count and the play average Xingtu publishes for the creator. Dividing a tier's quote by average plays gives a rough cost per view, a fairer way to compare creators than price alone.

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=douyin
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md