Douyin Xingtu Author Homepage Videos V1
## Purpose Retrieve videos listed on a Douyin Xingtu author's homepage, with optional video-type and assigned-video filters. ## Inputs - `oAuthorId` (required string): Xingtu author ID, for example `"7386881810501730341"`. - `page` (optional integer): Page number starting at 1; defaults to 1. Each page returns 20 items. - `videoType` (optional string): `ALL` for all videos (default), `PERSONAL` for personal videos, or `XINGTU` for Xingtu videos. - `onlyAssign` (optional boolean): Set to `true` to return only assigned videos; defaults to `false`. ## Results The response data is documented to include: - `items`: Video entries with `item_id`, `title`, `cover_uri`, `url`, `create_time`, `duration`, `watch_cnt` (views), `like_cnt` (likes), `comment_cnt` (comments), `finish_rate` (completion rate), and `interact_rate` (interaction rate). - `pagination`: `page` (current page), `limit` (page size), `total_count` (total count), and `has_more` (whether more pages are available). The response schema does not guarantee individual fields within the data; use the fields actually returned. This tool retrieves video listings and metrics, not video files. ## Example `{"oAuthorId":"7386881810501730341","page":1,"videoType":"ALL","onlyAssign":false}`
Pricing
| Condition | Charge |
|---|---|
| Each call | 41.31 credits/call |
41.31 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | 页码,从1开始,每页20条/Page number, starts from 1, 20 items per page | 1 |
oAuthorId | string | Yes | 星图达人ID/Xingtu author ID | — |
videoType | string | No | 流量类型:ALL/PERSONAL/XINGTU / Traffic type: ALL/PERSONAL/XINGTU | ALL |
onlyAssign | boolean | No | 是否仅返回指派视频/Only return assigned videos | false |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-KeyThis example shows part of the response. Copied content is valid JSON.

