Douyin-Xingtu-API

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

Changed on

[中文]

用途:

  • 获取星图达人主页的视频列表
  • 价格: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

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)
  • Auth
    HTTP bearer

Query parameters

oAuthorIdstring required

星图达人ID/Xingtu author ID

pageinteger

页码,从1开始,每页20条/Page number, starts from 1, 20 items per page

videoTypestring

流量类型:ALL/PERSONAL/XINGTU / Traffic type: ALL/PERSONAL/XINGTU

onlyAssignboolean

是否仅返回指派视频/Only return assigned videos

keywordstring

视频标题关键词筛选(可选)/Filter by video title keyword (optional)

startDatestring

起始日期(可选), 格式 yyyyMMdd/Start date (optional), format yyyyMMdd

endDatestring

结束日期(可选), 格式 yyyyMMdd/End date (optional), format yyyyMMdd

Response

Successful Response

codeinteger

HTTP status code | HTTP状态码

request_idstring nullable

Unique request identifier | 唯一请求标识符

messagestring

Response message (EN-US) | 响应消息 (English)

message_zhstring

Response message (ZH-CN) | 响应消息 (中文)

supportstring

Support message | 支持消息

timestring

The time the response was generated | 生成响应的时间

time_stampinteger

The timestamp the response was generated | 生成响应的时间戳

time_zonestring

The timezone of the response time | 响应时间的时区

docsstring nullable

Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接

cache_messagestring nullable

Cache message (EN-US) | 缓存消息 (English)

cache_message_zhstring nullable

Cache message (ZH-CN) | 缓存消息 (中文)

cache_urlstring nullable

The URL to access the cached result | 访问缓存结果的 URL

routerstring

The endpoint that generated this response | 生成此响应的端点

paramsunknown
dataunknown

Changes

    • info

      added the new optional query request parameter endDate

    • info

      added the new optional query request parameter keyword

    • info

      added the new optional query request parameter startDate

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status