---
title: "获取达人主页视频列表V1/Get Author Homepage Videos V1"
method: GET
path: "/api/v1/douyin/xingtu/author_homepage_videos_v1"
tags: ["Douyin-Xingtu-API"]
---

# 获取达人主页视频列表V1/Get Author Homepage Videos V1

`GET /api/v1/douyin/xingtu/author_homepage_videos_v1`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/douyin/xingtu/author_homepage_videos_v1`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取星图达人主页的视频列表
- 价格：0.02$ / 次
### 参数:
- oAuthorId: 星图达人ID，例如：7386881810501730341
- page: 页码，从 1 开始，每页返回 20 条
- videoType: 流量类型，可选值：
    - `ALL`: 全部视频（默认）
    - `PERSONAL`: 个人视频
    - `XINGTU`: 星图视频
- onlyAssign: 是否仅返回指派视频，默认 false
### 返回:
- 视频列表数据，包含:
    - items: 视频列表，每条含 item_id、title、cover_uri、url、create_time、duration、
      watch_cnt（播放数）、like_cnt（点赞数）、comment_cnt（评论数）、
      finish_rate（完播率）、interact_rate（互动率）等
    - pagination: 分页信息，含 page、limit、total_count、has_more

### 说明:
- 平台来源(platform_source)与平台渠道(platform_channel)由上游默认取 1，无需传入，
  上游会根据 oAuthorId 自动匹配平台。

# [English]
### Purpose:
- Get the video list on a Xingtu author's homepage
- Price: 0.02$ / time
### Parameters:
- oAuthorId: Xingtu author ID, for example: 7386881810501730341
- page: Page number, starts from 1, returns 20 items per page
- videoType: Traffic type, optional values:
    - `ALL`: All videos (default)
    - `PERSONAL`: Personal videos
    - `XINGTU`: Xingtu videos
- onlyAssign: Whether to return only assigned videos, default false
### Return:
- Video list data, including:
    - items: Video list, each with item_id, title, cover_uri, url, create_time, duration,
      watch_cnt, like_cnt, comment_cnt, finish_rate, interact_rate, etc.
    - pagination: Pagination info with page, limit, total_count, has_more

### Note:
- `platform_source` and `platform_channel` default to 1 upstream and do not need to be
  passed — the platform is matched automatically from `oAuthorId`.

# [示例/Example]
oAuthorId = "7386881810501730341"
page = 1
videoType = "ALL"
onlyAssign = False

## Query parameters

- `oAuthorId` string, required: 星图达人ID/Xingtu author ID
- `page` integer: 页码，从1开始，每页20条/Page number, starts from 1, 20 items per page
- `videoType` string: 流量类型：ALL/PERSONAL/XINGTU / Traffic type: ALL/PERSONAL/XINGTU
- `onlyAssign` boolean: 是否仅返回指派视频/Only return assigned videos
- `keyword` string: 视频标题关键词筛选(可选)/Filter by video title keyword (optional)
- `startDate` string: 起始日期(可选), 格式 yyyyMMdd/Start date (optional), format yyyyMMdd
- `endDate` string: 结束日期(可选), 格式 yyyyMMdd/End date (optional), format yyyyMMdd

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `cd87023a7e18`: 3 info
  - added the new optional `query` request parameter `endDate`
  - added the new optional `query` request parameter `keyword`
  - added the new optional `query` request parameter `startDate`
- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-23** `491c4018a5ed`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/xingtu/author_homepage_videos_v1/get.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)