Douyin Xingtu Author Spread Info

https://api.sandbase.ai/v1/api/douyin/xingtu-v2/author-spread-info

Retrieves commercial spread and reach capability data for a specific creator. Accepts filtering by time range, video type, flow type, and assignment status.

Price
$0.0015USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 6 optional
Production route

Try the model

Playground

Open playground
Input
Flow type, default 0
Creator/author ID
Only assigned videos, default False
Platform channel, default 1
Platform source, default 1
Time range, 2=last 30 days, 3=last 90 days
Video type, 1=personal video
OutputExample
Responseoutputs · 1.1 KB · 54 lines
[
  {
    "data": {
      "avg_duration": "20100",
      "base_resp": {
        "status_code": 0,
        "status_message": ""
      },
      "comment_avg": "1825",
      "expect_cpe": {
        "cpe_21_60": "124",
        "cpe_60": "227"
      },
      "expect_cpm": {
        "cpm_21_60": "5786",
        "cpm_60": "10609"
      },
      "interact_rate": {
        "label": "美食",
        "overtake": 6712,
        "value": 392
      },
      "item_num": "7",
      "item_rate": {
        "interact_rate": {},
        "item_num": {
          "label": "",
          "overtake": 6700,
          "value": 7
        },
        "play_mid": {
          "label": "",
          "overtake": 9998,
          "value": 4038696
        }
      },
      "like_avg": "111069",
      "play_mid": "4038696",
      "play_over_rate": {
        "label": "美食",
        "overtake": 3937,
        "value": 526
      },
      "play_stability": {
        "label": "美食"
      },
      "sales_expect_cpm": {
        "cpm_21_60": "7062",
        "cpm_60": "12947"
      },
      "share_avg": "60849"
    }
  }
]

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.0015 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

o_author_id
string · required
flow_type
integer · optional
only_assign
boolean · optional
platform_channel
integer · optional
platform_source
integer · optional
range
integer · optional
type
integer · optional

Access

Provider
Douyin
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/douyin/xingtu-v2/author-spread-info
Authentication
Bearer API key

API README

Douyin Xingtu Author Spread Info API

Look up commercial spread metrics for a creator on Douyin Xingtu using o_author_id. Filter performance stats across specific time windows using range.

Use cases

  • Evaluate commercial reach and spread capability for potential influencer partnerships.
  • Analyze creator performance across 30-day or 90-day historical time windows.
  • Compare personal video metrics against assigned commercial content.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/author-spread-info" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"o_author_id": "<o_author_id>"}'

Parameters

NameTypeRequiredDescription
o_author_idstringYesCreator/author ID
typeintegerNoVideo type, 1=personal video
rangeintegerNoTime range, 2=last 30 days, 3=last 90 days
flow_typeintegerNoFlow type, default 0
only_assignbooleanNoOnly assigned videos, default False
platform_sourceintegerNoPlatform source, default 1
platform_channelintegerNoPlatform channel, default 1

Notes

  • Use range to set the time window: 2 for the last 30 days, or 3 for the last 90 days.
  • Set type to 1 to filter for personal video spread data.
  • The only_assign flag filters exclusively for assigned videos when set to true.

Related APIs

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/douyin/xingtu-v2/author-spread-info
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/douyin/xingtu-v2/author-spread-info" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "o_author_id": "6677767167234015243",
  "range": 2,
  "type": 1
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
Douyin$0.0015 per callJSONJul 31, 2026
Douyin$0.003 per callJSONJul 31, 2026
Douyin$0.0015 per callJSONJul 31, 2026
Douyin$0.0015 per callJSONJul 31, 2026
Douyin$0.0015 per callJSONJul 31, 2026
Douyin$0.003 per callJSONJul 31, 2026

Questions

FAQ

How do I use the Douyin Xingtu Author Spread Info API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/xingtu-v2/author-spread-info with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Douyin Xingtu Author Spread Info API cost?

$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the Douyin Xingtu Author Spread Info API accept?

Required: o_author_id (string). Optional: flow_type (integer), only_assign (boolean), platform_channel (integer), platform_source (integer), range (integer) and type (integer). The Parameters table and the Playground on this page list every field.

What does the Douyin Xingtu Author Spread Info API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Douyin developer account or API key?

No. Douyin Xingtu Author Spread Info runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.