Accounts & creatorsDouyinCreator · Batch Detail

Douyin Xingtu creator batch info

Read allowlisted public commercial profile fields for up to 50 known Xingtu creator IDs.

POST/v1/douyin/xingtu/creators/batch-detail

Chinese name: 抖音星图达人批量基础信息 · 达人 · 批量详情一次读取最多 50 个已知星图达人 ID 的公开基础商业资料。
douyin.xingtu.creators.batch.detail@v1

Price per call

¥0.09/ 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_idsarrayrequired

minItems: 1 · maxItems: 50

Example: ["7029342444797820939","6675458265154846728"]

Request JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "author_ids": {
      "minItems": 1,
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9]{1,32}$"
      }
    }
  },
  "required": [
    "author_ids"
  ],
  "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/batch-detail \
  -H "Authorization: Bearer $DATAXAPI_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"author_ids":["7029342444797820939","6675458265154846728"]}'

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_batch_detail_v1", {
  "author_ids": [
    "7029342444797820939",
    "6675458265154846728"
  ]
});
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_batch_detail_v1", {
    "author_ids": [
        "7029342444797820939",
        "6675458265154846728",
    ],
})
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": {
    "items": [
      {
        "id": "7029342444797820939",
        "name": "Public creator",
        "avatar_url": "https://ci.douyin.com/star-avatar?sign=public",
        "city": "上海",
        "followers": 6971304,
        "expected_plays": 3594522,
        "categories": [
          "健身"
        ]
      }
    ],
    "missing_author_ids": [
      "6675458265154846728"
    ]
  },
  "page": {
    "next_cursor": null
  },
  "warnings": [
    "some_authors_unavailable"
  ],
  "meta": {
    "listing_id": "douyin.xingtu.creators.batch.detail",
    "version": "v1",
    "catalog_release_id": "catalog-production-2026-09-19.b069be57",
    "price_book_version": "pricebook-production-2026-09-19.4487e352",
    "result_status": "partial",
    "charged_amount": "0",
    "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": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[0-9]{1,32}$"
              },
              "name": {
                "type": "string"
              },
              "avatar_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "city": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "followers": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "expected_plays": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "categories": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            },
            "required": [
              "id",
              "name",
              "avatar_url",
              "city",
              "followers",
              "expected_plays",
              "categories"
            ],
            "additionalProperties": false
          }
        },
        "missing_author_ids": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[0-9]{1,32}$"
          }
        }
      },
      "required": [
        "items",
        "missing_author_ids"
      ],
      "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.batch.detail"
        },
        "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 reduce round trips for a known creator set.

Not for

Do not use it for creator discovery, private contacts, identity inference, or quote guarantees.

Known limitations

Up to 50 unique IDs per request.
Missing IDs make the result partial and nonchargeable.
Unverified quote-unit fields are intentionally omitted.

Billing

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

See all pricing →