--- title: "获取用户的作品列表/Get user posts" method: GET path: "/api/v1/tiktok/web/fetch_user_post" tags: ["TikTok-Web-API"] --- # 获取用户的作品列表/Get user posts `GET /api/v1/tiktok/web/fetch_user_post` ## 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/tiktok/web/fetch_user_post` - Auth: HTTP bearer # [中文] ### 用途: - 获取用户的作品列表 ### 参数: - secUid: 用户secUid - cursor: 翻页游标，首次请求传0，后续传上一次响应返回的 `cursor` 值 - count: 每页数量，默认为15，最大为15，超过15将按15处理。 - coverFormat: 封面格式，默认为2，可选值为1或2。 - post_item_list_request_type: 排序方式，已废弃，传任何值均返回按时间从新到旧的作品列表。 ### 返回: - 用户的作品列表，作品按发布时间从新到旧排列 - `cursor`: 下一页游标，配合 `hasMore` 使用 - `hasMore`: 是否还有更多作品，为 `false` 时表示已翻到最后一页 - 翻页时相邻两页可能出现少量重复作品，请按作品 `id` 去重后再统计或入库 ### 备注: - 此接口返回的视频CDN直链需要携带返回的 `tt_chain_token` 才能访问，否则会返回 HTTP 403。 - 访问视频CDN直链时，请在请求头中携带 `Cookie: tt_chain_token={tt_chain_token}`，其中 `{tt_chain_token}` 替换为接口返回的值。 - **如果视频CDN直链仍返回 HTTP 403**: 1. 请改用响应中以 `https://www.tiktok.com/aweme/v1/play/` 开头的视频链接(位于 `video` 下各 `UrlList` 中) 2. 请求该链接时**不要携带任何 Cookie**，携带 `tt_chain_token` 会导致 HTTP 403 - 如果需要无需任何 Cookie 即可直接访问的无水印视频链接，请使用 `/fetch_post_detail` 或 TikTok APP V3 目录下的接口。 # [English] ### Purpose: - Get user posts ### Parameters: - secUid: User secUid - cursor: Page cursor. Pass 0 for the first request, then pass the `cursor` value returned by the previous response. - count: Number per page, default is 15, maximum is 15. Values above 15 are treated as 15. - coverFormat: Cover format, default is 2, optional values are 1 or 2. - post_item_list_request_type: Sort type. Deprecated - any value returns posts ordered from newest to oldest. ### Return: - User posts, ordered from newest to oldest - `cursor`: Cursor for the next page, use together with `hasMore` - `hasMore`: Whether more posts are available; `false` means the last page has been reached - Consecutive pages may contain a few overlapping posts; de-duplicate by post `id` before counting or storing ### Note: - The direct video CDN links returned by this interface require the returned `tt_chain_token` to be accessed, otherwise HTTP 403 will be returned. - When accessing a direct video CDN link, carry `Cookie: tt_chain_token={tt_chain_token}` in the request header, where `{tt_chain_token}` is the value returned by this interface. - **If a direct video CDN link still returns HTTP 403**: 1. Use the video link starting with `https://www.tiktok.com/aweme/v1/play/` from the response instead (found in the `UrlList` fields under `video`) 2. Send that link **without any Cookie** - carrying `tt_chain_token` will cause HTTP 403 - If you need watermark-free video links that require no Cookie at all, use `/fetch_post_detail` or the interfaces under the TikTok APP V3 directory. # [示例/Example] secUid = "MS4wLjABAAAAv7iSuuXDJGDvJkmH_vz1qkDZYo1apxgzaxdBSeIuPiM" cursor = 0 post_item_list_request_type = 0 count = 15 coverFormat = 2 ## Query parameters - `secUid` string, required: 用户secUid/User secUid - `cursor` integer: 翻页游标/Page cursor - `count` integer: 每页数量，最大15/Number per page, max 15 - `coverFormat` integer: 封面格式/Cover format - `post_item_list_request_type` integer: 排序方式（已废弃，不再生效）/Sort type (deprecated, no longer effective) ## 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-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-01** `50f9ec6e1cd3`: 1 breaking, 1 warning, 2 info - for the `query` request parameter `count`, default value was changed from `20` to `15` - for the `query` request parameter `cursor`, the min was set to `0.00` - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200` - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200` - …earlier changes not shown [Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/tiktok/web/fetch_user_post/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)