Douyin Xingtu creator audience API

Who follows a Douyin creator, by Xingtu creator ID: followers and share in each segment of gender, age, province, city (top ten), city tier, interest, phone brand, consumer group, shopping category and order size, with when Xingtu last measured it. A share is the segment's count over the total of the segments listed.

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

Also calledxingtu follower profilecreator audience demographics

Price: $0.004; per call · failed calls are free
Returns: One Audience; as data.item
If a call fails: Not charged; When a data source fails, the next one is tried; errors and timeouts cost nothing.
Status: preview; It may still change; any change is announced beforehand.

Parameters

Name	Type	Description
`id`required	string	The Xingtu creator ID (digits), from the Xingtu creator search; not the Douyin account ID. e.g. `6763236383382306828`
`view`	stringcompactstandardfull	How much of each object comes back. full adds platform-specific fields under ext. default `standard`
`fields`	string[]	Fields to keep, by path (author.name), to save tokens. In a query string: comma-separated.

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

Request

cURL

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

Python

import os
import requests

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

row = body["data"]["item"]
print(row)
print("cost: $" + body["meta"]["billing"]["amount"])

TypeScript

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

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);
console.log('cost: $' + body.meta.billing.amount);

MCPtools/call

{
  "name": "call",
  "arguments": {
    "capability": "douyin.xingtu.creators.audience.get",
    "id": "6763236383382306828"
  }
}

Response

200 · application/jsonmeta.billing.amount = 0.004

{
  "code": "ok",
  "request_id": "0f6c2a8e-4b1d-4e0a-9a51-3c7d2b9e1f20",
  "data": {
    "item": {
      "creator_id": null,
      "measured_at": null,
      "gender": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "age": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "province": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "city": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "interest": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "device": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "city_tier": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "crowd": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "purchase_category": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ],
      "purchase_amount": [
        {
          "name": null,
          "share": null,
          "count": null
        }
      ]
    }
  },
  "warnings": [],
  "meta": {
    "capability": "douyin.xingtu.creators.audience.get",
    "billing": {
      "amount": "0.004",
      "currency": "USD",
      "balance_after": "9.996"
    },
    "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.004. Failed calls are free. Your key goes only to that address and is never stored on this site.

Returned fields

data.item is one Audience.

Field	Type	View	Description
`creator_id`	string	compact	The creator ID asked about.
`measured_at`	string \| null	compact	The day the figures are of, as 00:00 China time.
`gender`	AudienceSegment[] \| null	compact	By gender.
`age`	AudienceSegment[] \| null	compact	By age group.
`province`	AudienceSegment[] \| null	compact	By province.
`city`	AudienceSegment[] \| null	compact	By city, the largest only.

Show all 13 fieldsHide the other 7

Field	Type	View	Description
`interest`	AudienceSegment[] \| null	compact	By interest.
`device`	AudienceSegment[] \| null	compact	By phone brand.
`city_tier`	AudienceSegment[] \| null	compact	By city tier.
`crowd`	AudienceSegment[] \| null	compact	By the consumer groups the platform sorts people into.
`purchase_category`	AudienceSegment[] \| null	compact	By the category of goods bought.
`purchase_amount`	AudienceSegment[] \| null	compact	By the amount spent per order.
`ext`	object	full	Platform-specific extras. Only returned with view=full.

The view column is the smallest view a field comes back in: compact returns only compact fields, standard adds the standard ones, full returns everything. The default is standard.

When it is charged

One call costs $0.004 and returns one audience. 1,000 lookups cost $4.00. Failed calls are not charged.

Data comes back$0.004 per call

Bad parameters, errors, timeoutsFree

When	Charge
Most one call costs	$0.004
An empty answer	Free
Not found (the platform has no such item)	$0.004
Bad parameters, errors, timeouts	Free
A retry with the same Idempotency-Key within 24 hours	Charged once

A failed call is free; an empty answer is free; not found costs $0.004.

Prices from price book 1b273c48fea9634e. Every price on this platform →

Common errors

Every error has the same shape and says whether it was charged. The ones this endpoint can return:

HTTP	Code	Meaning	Charged
400	`invalid_params`	A parameter is missing, has the wrong type or value, or the method is wrong. problems lists each one; param names the first.Retry: after a fix	no
401	`unauthorized`	The key is missing, malformed, revoked, disabled or expired (reason says which when known).Retry: no	no
402	`insufficient_balance`	The balance (available) cannot cover the most this call could cost (required).Retry: after a fix	no
404	`not_found`	The post, account or page does not exist or is not public. Endpoints whose charge_when_not_found is above 0 charge this answer (the source billed us for it): the body then says charged: true and amount.Retry: no	no
429	`rate_limited`	The account sent too many requests this minute (reason: rate) or has too many calls running (reason: concurrency).Retry: yes	no
500	`settlement_unknown`	The data came back, but the charge could not be confirmed.Retry: with the same Idempotency-Key	unknown until looked up
502	`upstream_failed`	Every data source for this endpoint failed on this request.Retry: yes	no
503	`capability_paused`	This endpoint is paused right now; nothing ran.Retry: yes	no
504	`timeout`	The data did not come back in time. The hold was released, so nothing was charged.Retry: yes	no

All error codes →

Questions

How much does the Douyin Xingtu creator audience API cost?

One call costs $0.004 and returns one audience. 1,000 lookups cost $4.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).

Use it in your AI

Paste this into Claude, ChatGPT, Cursor or any agent that can open a web page. It reads this endpoint’s page and calls it with your key.

Read https://okdata.online/apis/douyin/xingtu/creators/audience/get.md, then call this endpoint for me through okdata; my key is in the OKDATA_API_KEY environment variable. Use Douyin Xingtu creator audience and sum up what comes back.

With the MCP server connected, just ask: Use Douyin Xingtu creator audience and sum up what comes back.

Connect your agent → MCP →