Accounts & creatorsDouyinCreator Audience · Detail

Douyin Xingtu creator audience

Read aggregated public commercial audience distributions for a known Xingtu creator.

POST/v1/douyin/xingtu/creators/audience

Chinese name: 抖音星图达人粉丝画像 · 达人受众 · 详情按星图达人 ID 读取当前公开商业粉丝画像分布。
douyin.xingtu.creators.audience@v1

Price per call

¥0.05/ call

Complete and confirmed empty results are charged; partial results and failures are not.

AvailableChecking live status →

Checking live status

Try it

Request JSON body

Security check

Loading the security check…

6-digit code

Checking live execution status…

Execution result

// Result

Request parameters

author_idstringrequired

pattern: "^[0-9]{1,32}$"

Example: "7029342444797820939"

Request JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "author_id": {
      "type": "string",
      "pattern": "^[0-9]{1,32}$"
    }
  },
  "required": [
    "author_id"
  ],
  "additionalProperties": false
}

Code samples

Install the SDK with npm i @dataxapi/sdk or pip install dataxapi, and put your API key in the DATAXAPI_API_KEY environment variable.

curl -X POST https://api.dataxapi.com/v1/douyin/xingtu/creators/audience \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"author_id":"7029342444797820939"}'

import { ExactApiClient } from "@dataxapi/sdk";

const client = new ExactApiClient({
  baseUrl: "https://api.dataxapi.com",
  apiKey: process.env.DATAXAPI_API_KEY,
});

const result = await client.call("douyin_xingtu_creators_audience_v1", {
  "author_id": "7029342444797820939"
});
console.log(result.data);

import os
from dataxapi import ExactApiClient

client = ExactApiClient("https://api.dataxapi.com", os.environ["DATAXAPI_API_KEY"])

result = client.call("douyin_xingtu_creators_audience_v1", {
    "author_id": "7029342444797820939",
})
print(result["data"])

[mcp_servers.dataxapi]
url = "https://api.dataxapi.com/mcp"
bearer_token_env_var = "DATAXAPI_API_KEY"

Response example

200 · application/json

{
  "code": 200,
  "request_id": "req_example_batch_5_douyin",
  "message": "success",
  "data": {
    "dimensions": [
      {
        "name": "性别分布",
        "description": "男性居多",
        "buckets": [
          {
            "key": "female",
            "value": 540361
          },
          {
            "key": "male",
            "value": 6428363
          }
        ]
      }
    ],
    "observed_at": "2026-08-26T22:52:35.000Z"
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [],
  "meta": {
    "listing_id": "douyin.xingtu.creators.audience",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "complete",
    "charged_amount": "0.05",
    "balance_after": "49.95",
    "currency": "CNY"
  }
}

Response fields

codenumber: const: 200
request_idstring
messagestring: const: "success"
dataobject
pageobject
warningsarray
metaobject

Response JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "code": {
      "type": "number",
      "const": 200
    },
    "request_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "const": "success"
    },
    "data": {
      "type": "object",
      "properties": {
        "dimensions": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "buckets": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "key": {
                      "type": "string"
                    },
                    "value": {
                      "type": "integer",
                      "minimum": 0,
                      "maximum": 9007199254740991
                    }
                  },
                  "required": [
                    "key",
                    "value"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "name",
              "description",
              "buckets"
            ],
            "additionalProperties": false
          }
        },
        "observed_at": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "dimensions",
        "observed_at"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "type": "null"
        }
      },
      "required": [
        "next_cursor"
      ],
      "additionalProperties": false
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "listing_id": {
          "type": "string",
          "const": "douyin.xingtu.creators.audience"
        },
        "version": {
          "type": "string",
          "const": "v1"
        },
        "catalog_release_id": {
          "type": "string",
          "minLength": 1
        },
        "price_book_version": {
          "type": "string",
          "minLength": 1
        },
        "result_status": {
          "type": "string",
          "enum": [
            "complete",
            "empty",
            "partial"
          ]
        },
        "charged_amount": {
          "type": "string"
        },
        "balance_after": {
          "type": "string"
        },
        "currency": {
          "type": "string",
          "const": "CNY"
        }
      },
      "required": [
        "listing_id",
        "version",
        "catalog_release_id",
        "price_book_version",
        "result_status",
        "charged_amount",
        "balance_after",
        "currency"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "code",
    "request_id",
    "message",
    "data",
    "page",
    "warnings",
    "meta"
  ],
  "additionalProperties": false
}

Usage notes

Good for

Use it to compare aggregated gender, age, region, or interest dimensions.

Not for

Do not use it for individual identification, sensitive profiling, or conversion causality.

Known limitations

The live sample returned 10 aggregate dimensions.
Dimensions can use different denominators.
The snapshot is not guaranteed to be real time.

Billing

¥0.05 per call. Complete and confirmed empty results are charged; partial results and failures are not.

See all pricing →