# How to look up a Douyin creator's Xingtu rate card

2 endpoints do it: Douyin Xingtu creator search → Douyin Xingtu creator rate card. The worked example below is 6 calls and costs $0.204 in all; a failed call is not charged.

Find creators on Xingtu, Douyin's own marketplace for sponsored content, by name, then get each one's rate card: the rate for every kind of sponsored work, how it is settled, and whether they take it now. Useful for comparing rates and shortlisting creators before a campaign.

## Step by step

### Step 1: Douyin Xingtu creator search

Search Xingtu creators by words in their name, 20 a page. Each item's `id` is the Xingtu creator ID the next step takes. Add `view=full` to see up front what a 21 to 60 second video and a video over 60 seconds cost (`ext.rate_21_60s`, `ext.rate_over_60s`) and the views expected of one (`ext.expected_views`), for a first cut. ([Douyin Xingtu creator search](https://dataxapi.com/apis/douyin/xingtu/creators/search/), $0.0040 / a call)

cURL

```bash
curl -G "https://api.dataxapi.com/v1/douyin/xingtu/creators/search" \
  --data-urlencode "query=美食" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

Python

```python
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.douyin.xingtu.creators.search(query="美食")
print(result["data"]["items"])
```

TypeScript

```typescript
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.douyin.xingtu.creators.search({ query: "美食" });
console.log(result.data.items);
```

CLI

```bash
dataxapi call douyin.xingtu.creators.search 'query=美食'
```

Recorded response: From a response recorded 2026-10-12 22:06 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

```jsonc
{
  "code": "ok",
  "request_id": "868ddbde-b3c7-4d7f-b06d-9222e36252a7",
  "data": {
    "items": [
      {
        "id": "6811001738597474041",
        "name": "橘子汽水不加冰",
        "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_49724ca5b7a50c72cbe5.jpeg",
        "location": "北京",
        "categories": ["户外"],
        "subcategories": ["家居好物"],
        "metrics": { "followers": 48169 }
      },
      // … 19 more
    ]
  },
  "page": {
    "next_cursor": "c1.Xg3q38In7offq-5CuKi-UcARHThe6dxGEKhgaR5D",
    "cursor_expires_at": "2026-10-12T23:06:50.000Z",
    "has_more": true,
    "returned": 20
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T22:06:50.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": { "account_id": "capability", "username": "capability" },
    "billing": {
      "amount": "0.004",
      "currency": "USD",
      "balance_after": "9.996"
    }
  }
}
```

### Step 2: Douyin Xingtu creator rate card

Put the Xingtu creator ID into `id` to get the creator's rate for each kind of work. Each entry of `rates` has the kind of work (`name`), the rate (`amount`) and how it is settled (`settlement`); `open` says whether they take that kind of work now. ([Douyin Xingtu creator rate card](https://dataxapi.com/apis/douyin/xingtu/creators/rates/get/), $0.0400 / a call)

cURL

```bash
curl -G "https://api.dataxapi.com/v1/douyin/xingtu/creators/rates/get" \
  --data-urlencode "id=6629656444889202692" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
```

Python

```python
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.douyin.xingtu.creators.rates.get(id="6629656444889202692")
print(result["data"]["item"])
```

TypeScript

```typescript
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.douyin.xingtu.creators.rates.get({ id: "6629656444889202692" });
console.log(result.data.item);
```

CLI

```bash
dataxapi call douyin.xingtu.creators.rates.get id=6629656444889202692
```

Recorded response: From a response recorded 2026-10-10 14:02 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

```jsonc
{
  "code": "ok",
  "request_id": "ad52d689-43bc-419f-8e8d-fee750a32290",
  "data": {
    "item": {
      "creator_id": "6187694769211204659",
      "currency": "CNY",
      "rates": [
        {
          "name": "植入视频",
          "amount": "400000",
          "settlement": "固定价格",
          "open": true
        },
        {
          "name": "定制视频",
          "amount": "500000",
          "settlement": "固定价格",
          "open": true
        },
        // … 4 more
      ]
    }
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.rates.get",
    "result_status": "complete",
    "fetched_at": "2026-10-10T14:02:30.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {},
    "billing": {
      "amount": "0.04",
      "currency": "USD",
      "balance_after": "9.96"
    }
  }
}
```

## What the example costs

One page of Xingtu creators (20), then the full rate card of 5 of them

| Endpoint | Calls | Price | Subtotal |
| --- | --- | --- | --- |
| [Douyin Xingtu creator search](https://dataxapi.com/apis/douyin/xingtu/creators/search/) | 1 | $0.0040 | $0.0040 |
| [Douyin Xingtu creator rate card](https://dataxapi.com/apis/douyin/xingtu/creators/rates/get/) | 5 | $0.0400 | $0.20 |
| Total | 6 |  | $0.204 |

Prices are the prices in force when this page was built. A failed call, and an object that does not exist, cost nothing.

## In your AI (MCP)

Connect DataXAPI to your AI client once. Then say what you want; the agent finds these endpoints, checks the price and calls them on your balance.

Say: Search Douyin's Xingtu for creators matching 美食 (food), take the 5 with the most followers, and list the rate and settlement of each kind of sponsored work they offer, as one table.

What the agent sends to the call tool: 

```json
{
  "capability": "douyin.xingtu.creators.search",
  "query": "美食",
  "idempotency_key": "<a new UUID>"
}
```

[About the MCP server](https://dataxapi.com/mcp/)

## Good to know

- A Xingtu creator ID is a string of digits and is not the Douyin account ID; the other Xingtu endpoints take it too. Search results carry no Douyin account ID or handle (`account_id`, `username`): get them from the Xingtu creator profile, by ID.
- `currency` gives the currency of the rates. A kind of work with no fixed rate (one settled by views, say) has a `null` `amount`.
- Search matches creators' names, not what they post about; a `page.next_cursor` is good for an hour. A search with no results is charged; a rate card that cannot be found is not.

## Endpoints

- [Douyin Xingtu creator search](https://dataxapi.com/apis/douyin/xingtu/creators/search/)
- [Douyin Xingtu creator rate card](https://dataxapi.com/apis/douyin/xingtu/creators/rates/get/)

## More about Douyin

- [Douyin API](https://dataxapi.com/apis/douyin/)
- [Douyin Xingtu API](https://dataxapi.com/apis/douyin/xingtu/)
- [How to get Douyin keyword trends in bulk](https://dataxapi.com/guides/douyin-keyword-trends/)
- [How to export Douyin video comments in bulk](https://dataxapi.com/guides/douyin-video-comments/)
- [How do I export Douyin data?](https://dataxapi.com/answers/export-douyin-data/)

---

Catalog revision c48ce454ae6c4c65. [HTML version](https://dataxapi.com/guides/douyin-xingtu-creator-rates/)
