---
title: "获取首页推荐数据/Get home feed data"
method: POST
path: "/api/v1/douyin/web/fetch_home_feed"
tags: ["Douyin-Web-API"]
---

# 获取首页推荐数据/Get home feed data

`POST /api/v1/douyin/web/fetch_home_feed`

## 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/web/fetch_home_feed`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取首页推荐数据
### 参数:
- count: 数量，默认为10，建议保持不变。
- refresh_index: 刷新/翻页索引，从 0 开始，每翻一页 +1。
    - refresh_index=0：刷新（首次进入/下拉刷新）
    - refresh_index>0：翻页（下滑加载更多）
- cookie: 可选，用户网页版抖音登录Cookie。传入后返回该账号的个性化推荐；不传则以游客身份获取通用推荐。
### 返回:
- Feed数据

# [English]
### Purpose:
- Get home feed data
### Parameters:
- count: Number, default is 10, it is recommended to keep it unchanged.
- refresh_index: Refresh/paging index, start at 0 and +1 per page.
    - refresh_index=0: refresh (first entry / pull-to-refresh)
    - refresh_index>0: load-more (scroll down)
- cookie: Optional, your web version of Douyin login Cookie. Returns a personalized feed for that account; returns a general guest feed if omitted.
### Return:
- Feed data

# [示例/Example]
count = 10
refresh_index = 0
cookie = ""

## Request body

- BodyFetchHomeFeedApiV1DouyinWebFetchHomeFeedPost
  - `count` integer: 数量/Number
  - `refresh_index` integer: 刷新/翻页索引：0=刷新(首页/下拉)，>0=翻页(下滑加载更多)，每次+1取下一页 / Refresh-paging index: 0=refresh, >0=load-more, increment by 1 for next page
  - `cookie` string: 可选/Optional：用户网页版抖音登录Cookie，传入后返回该账号的个性化推荐；不传则以游客身份访问/Your web Douyin login Cookie for a personalized feed; guest access if omitted

## 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 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/douyin/web/fetch_home_feed/post.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)