{ "openapi": "3.1.0", "info": { "title": "Douyin Creator Marketplace (Xingtu) Spread Metrics API (V1)", "version": "v0", "description": "Returns Douyin Creator Marketplace (Xingtu) spread metrics for a creator, with channel, period, video-type, assignment, and flow filters. Use it to compare creator spread performance during campaign planning." }, "servers": [ { "url": "https://api.justoneapi.com", "description": "Global production API (default)" } ], "tags": [ { "name": "Douyin Creator Marketplace (Xingtu)", "description": "Douyin Xingtu creator metrics, audience structure, commerce data, and campaign analytics for creator marketing.", "x-platform-id": "douyin-creator-marketplace-xingtu", "x-platform-aliases": [ "Douyin Xingtu", "Xingtu", "巨量星图", "星图" ], "x-platform-detection-aliases": [ "Douyin Xingtu", "Xingtu", "巨量星图", "星图" ] } ], "paths": { "/api/douyin-xingtu/gw/api/data_sp/get_author_spread_info/v1": { "get": { "tags": [ "Douyin Creator Marketplace (Xingtu)" ], "summary": "Spread Metrics", "description": "Returns Douyin Creator Marketplace (Xingtu) spread metrics for a creator, with channel, period, video-type, assignment, and flow filters. Use it to compare creator spread performance during campaign planning.", "operationId": "getApiDouyinXingtuGwApiDataSpGetAuthorSpreadInfoV1", "parameters": [ { "name": "token", "in": "query", "description": "User authentication token.", "required": true, "schema": { "type": "string" } }, { "name": "oAuthorId", "in": "query", "description": "Author's unique ID.", "required": true, "schema": { "type": "string" } }, { "name": "platform", "in": "query", "description": "Platform type.\n\nAvailable Values:\n- `SHORT_VIDEO`: Short video\n- `LIVE_STREAMING`: Live streaming\n- `PICTURE_TEXT`: Picture and text\n- `SHORT_DRAMA`: Short drama", "required": false, "schema": { "type": "string", "default": "SHORT_VIDEO", "description": "Platform type", "enum": [ "SHORT_VIDEO", "LIVE_STREAMING", "PICTURE_TEXT", "SHORT_DRAMA" ] } }, { "name": "range", "in": "query", "description": "Time range.\n\nAvailable Values:\n- `DAY_30`: Last 30 days\n- `DAY_90`: Last 90 days", "required": false, "schema": { "type": "string", "default": "DAY_30", "description": "Time range", "enum": [ "DAY_30", "DAY_90" ] } }, { "name": "type", "in": "query", "description": "Video type.\n\nAvailable Values:\n- `PERSONAL_VIDEO`: Personal video\n- `XINTU_VIDEO`: Xingtu video", "required": false, "schema": { "type": "string", "default": "PERSONAL_VIDEO", "description": "Author video type", "enum": [ "PERSONAL_VIDEO", "XINTU_VIDEO" ] } }, { "name": "onlyAssign", "in": "query", "description": "Whether to only include assigned videos.", "required": false, "schema": { "type": "boolean", "default": false } }, { "name": "flowType", "in": "query", "description": "Flow type filter.\n\nAvailable Values:\n- `EXCLUDE`: Exclude\n- `INCLUDE`: Include", "required": false, "schema": { "type": "string", "default": "EXCLUDE", "description": "Flow filter type", "enum": [ "EXCLUDE", "INCLUDE" ] } } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "400": { "description": "Invalid request parameters or body", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "401": { "description": "Invalid or inactive access token", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "403": { "description": "Permission denied", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "429": { "description": "Request rate or daily quota limit exceeded", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } }, "503": { "description": "Service temporarily unavailable", "content": { "application/json": { "schema": { "type": "object", "properties": { "code": { "type": "integer", "format": "int32", "enum": [ 0, 100, 101, 202, 300, 301, 302, 303, 400, 404, 500, 503, 600, 601, 602 ] }, "message": { "type": [ "string", "null" ] }, "data": {}, "recordTime": { "type": [ "string", "null" ] }, "requestId": { "type": "string" } }, "required": [ "code", "data", "message", "recordTime" ] } } } } }, "x-order": "15001900", "x-api-version": "v1", "x-search-aliases": [ "Douyin Xingtu creator spread metrics", "Xingtu influencer content reach", "Douyin creator video spread analysis", "抖音星图达人传播指标", "星图达人内容传播数据", "抖音达人视频传播分析" ], "x-highlights": [], "x-endpoint-family": "douyin_xingtu_gw_api_data_sp_get_author_spread_info" } } } }