---
title: "按分类获取Reddit APP feed/Fetch Reddit APP Topic Feed"
method: GET
path: "/api/v1/reddit/app/fetch_topic_feed"
tags: ["Reddit-APP-API"]
---

# 按分类获取Reddit APP feed/Fetch Reddit APP Topic Feed

`GET /api/v1/reddit/app/fetch_topic_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/reddit/app/fetch_topic_feed`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取指定 topic(社区分类)的 feed
- 一般流程: 先调 `/fetch_explore_feed` 获取所有 topicId,然后选一个 topicId 调这个接口
### 参数:
- topic_id: 分类ID,格式 "tx1_XXXXX",从 `/fetch_explore_feed` 返回的 `topics[].id` 取
- scheme_name: 分类 scheme,App 默认用 "communities_tab_taxonomy_topics_default"
- sort: 排序方式
- time: 时间范围
- need_format: 是否清洗
### 注意:
- **APP接口的ID格式与Web接口不同,需要添加类型前缀**
- 分类ID前缀: tx1_ (例如: tx1_29m4k39)
- scheme_name 是 Reddit 内部分类体系标识,默认值即可

# [English]
### Purpose:
- Fetch the feed for a specific Reddit community topic
- Typical flow: call `/fetch_explore_feed` first to get topicIds, then pass one here
### Parameters:
- topic_id: Topic ID, format "tx1_XXXXX", get from `/fetch_explore_feed` response's `topics[].id`
- scheme_name: Topic scheme, App defaults to "communities_tab_taxonomy_topics_default"
- sort: Sort method
- time: Time range
- need_format: Whether to clean

# [示例/Example]
topic_id="tx1_29m4k39"
scheme_name="communities_tab_taxonomy_topics_default"
sort="BEST"
time="ALL"
need_format=false

## Query parameters

- `language` string: 返回内容使用的语言，采用 IETF 语言标签；默认 en-US / Preferred response language as an IETF language tag; default: en-US
- `topic_id` string, required: 分类ID/Topic ID (从 /fetch_explore_feed 的 topics 拿)
- `scheme_name` string: 分类 scheme/Topic scheme name (默认 App 用 communities_tab_taxonomy_topics_default)
- `sort` 'BEST' | 'HOT' | 'NEW' | 'TOP' | 'CONTROVERSIAL' | 'RISING': 排序方式/Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL
- `time` 'ALL' | 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR': 时间范围/Time range: ALL, HOUR, DAY, WEEK, MONTH, YEAR
- `need_format` boolean: 是否需要清洗数据/Whether to clean and format the data

## 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-05** `eab99e8bfe5b`: 6 breaking, 2 warning, 13 info
  - the `query` request parameter `sort` was restricted to a list of enum values
  - the `query` request parameter `time` was restricted to a list of enum values
  - for the `query` request parameter `scheme_name`, the minLength was increased from `0` to `1`
  - for the `query` request parameter `topic_id`, the minLength was increased from `0` to `5`
  - …17 more
- **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/reddit/app/fetch_topic_feed/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)
