Douyin Xingtu Author Homepage Videos V1

41.31 credits/call
ae_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}`

VideoSocial
41.31 credits/call

Pricing

41.31 credits/call
ConditionCharge
Each call41.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.

ParameterTypeRequiredDescriptionDefault
pageintegerNo页码,从1开始,每页20条/Page number, starts from 1, 20 items per page1
oAuthorIdstringYes星图达人ID/Xingtu author ID—
videoTypestringNo流量类型:ALL/PERSONAL/XINGTU / Traffic type: ALL/PERSONAL/XINGTUALL
onlyAssignbooleanNo是否仅返回指派视频/Only return assigned videosfalse

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_douyin_xingtu_author_homepage_videos_v1' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "oAuthorId": "6743610023982661639",
    "page": 1,
    "videoType": "ALL"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "base_resp": {
      "status_code": 0,
      "status_message": ""
    },
    "items": [
      {
        "comment_cnt": "141",
        "content_theme_labels": [],
        "cover_uri": "tos-cn-p-0015c000-ce/oEGVk1evqAN6C7DHgIFU8e8D3f0D6AuEJBCHyQ",
        "create_time": "1794734090",
        "title": "一曲我心永恒送给有缘人#石磊在路上 #我心永恒",
        "url": "https://www.iesdouyin.com/share/video/7708324222507407353/?region=CN&mid=6610664419187755778&u_code=lf05dekc&did=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_"
      }
    ],
    "pagination": {
      "has_more": true,
      "limit": 20,
      "page": 1,
      "total_count": 52
    }
  },
  "docs": "https://api.tikhub.io/#/Douyin-Xingtu-V2-API/get_author_homepage_videos_api_v1_douyin_xingtu_v2_get_author_homepage_videos_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {
    "o_author_id": "6743610023982661639",
    "page": "1"
  }
}

This example shows part of the response. Copied content is valid JSON.