Douyin Xingtu creator video performance API

Try it

Sign in and run one real call. The result and charge appear right here.

Request JSON body

Email

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"

cursorstringoptional

minLength: 1

Request JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "author_id": {
      "type": "string",
      "pattern": "^[0-9]{1,32}$"
    },
    "cursor": {
      "type": "string",
      "minLength": 1
    }
  },
  "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/videos \
  -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_videos_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_videos_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": {
    "items": [
      {
        "id": "7674200354665352491",
        "title": "Public commercial video",
        "cover_url": "https://ci.douyin.com/star-cover?sign=public",
        "published_at": "2026-08-15T09:11:53.000Z",
        "duration_seconds": 197,
        "finish_rate": 0.076033,
        "interaction_rate": 0.025495,
        "watch_count": 1640713,
        "likes": 39233,
        "comments": 1383,
        "content_themes": [
          "家庭育儿",
          "个人成长"
        ],
        "permalink": "https://www.douyin.com/video/7674200354665352491"
      }
    ]
  },
  "page": {
    "next_cursor": "cursor_example"
  },
  "warnings": [],
  "meta": {
    "listing_id": "douyin.xingtu.creators.videos",
    "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": {
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[0-9]{1,32}$"
              },
              "title": {
                "type": "string"
              },
              "cover_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "published_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "duration_seconds": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "finish_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "interaction_rate": {
                "anyOf": [
                  {
                    "type": "number",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "watch_count": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "likes": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "comments": {
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9007199254740991
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "content_themes": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "permalink": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "title",
              "cover_url",
              "published_at",
              "duration_seconds",
              "finish_rate",
              "interaction_rate",
              "watch_count",
              "likes",
              "comments",
              "content_themes",
              "permalink"
            ],
            "additionalProperties": false
          }
        }
      },
      "required": [
        "items"
      ],
      "additionalProperties": false
    },
    "page": {
      "type": "object",
      "properties": {
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "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.videos"
        },
        "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 public commercial content performance for shortlisted creators.

Not for

Do not use it for private creator analytics, conversion attribution, or ranking causality.

Known limitations

The live first page returned 20 items.
Finish and interaction rates use the current Xingtu commercial definition.
Only public content performance metrics are returned; conversion, sales, and attribution data are not included.

Billing

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

See all pricing →