---
title: "获取Reddit APP版块设置/Fetch Reddit APP Subreddit Settings"
method: GET
path: "/api/v1/reddit/app/fetch_subreddit_settings"
tags: ["Reddit-APP-API"]
---

# 获取Reddit APP版块设置/Fetch Reddit APP Subreddit Settings

`GET /api/v1/reddit/app/fetch_subreddit_settings`

## 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_subreddit_settings`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取Reddit APP指定版块的设置信息,包括发帖规则、用户标签设置、审核设置等配置信息
### 参数:
- subreddit_id: 版块ID,格式为t5_开头的唯一标识符,例如"t5_2qh0u"(可从fetch_subreddit_info接口获取版块ID)
### 返回:
- 指定版块的设置信息JSON数据,包含以下主要字段:
  - subredditType: 版块类型(public/private/restricted)
  - submissionType: 允许提交的内容类型(any/link/self)
  - allowImages: 是否允许图片
  - allowVideos: 是否允许视频
  - allowPolls: 是否允许投票
  - suggestedCommentSort: 建议的评论排序方式
  - spoilersEnabled: 是否启用剧透标记
  - allowedPostTypes: 允许的帖子类型配置
  - contentOptions: 内容选项设置
  - flairSettings: 用户/帖子标签设置
### 注意事项:
- 需要先通过fetch_subreddit_info接口获取版块ID(subreddit.id字段)
- 版块ID格式必须为"t5_"开头
- **APP接口的ID格式与Web接口不同，需要添加类型前缀**
- 版块ID前缀: t5_ (例如: t5_2qh0u)

# [English]
### Purpose:
- Fetch settings information of a specified Reddit APP subreddit, including posting rules, flair settings, moderation settings, and other configurations
### Parameters:
- subreddit_id: Subreddit ID with format starting with t5_, e.g., "t5_2qh0u" (can be obtained from the fetch_subreddit_info endpoint)
### Returns:
- JSON data containing subreddit settings with the following main fields:
  - subredditType: Subreddit type (public/private/restricted)
  - submissionType: Allowed submission content types (any/link/self)
  - allowImages: Whether images are allowed
  - allowVideos: Whether videos are allowed
  - allowPolls: Whether polls are allowed
  - suggestedCommentSort: Suggested comment sort method
  - spoilersEnabled: Whether spoiler tags are enabled
  - allowedPostTypes: Allowed post types configuration
  - contentOptions: Content options settings
  - flairSettings: User/post flair settings
### Notes:
- You need to first get the subreddit ID (subreddit.id field) via the fetch_subreddit_info endpoint
- Subreddit ID format must start with "t5_"
- **APP API ID format differs from Web API, requires type prefix**
- Subreddit ID prefix: t5_ (e.g., t5_2qh0u)

# [示例/Example]
subreddit_id="t5_2qh0u"
need_format=false

## Query parameters

- `language` string: 返回内容使用的语言，采用 IETF 语言标签；默认 en-US / Preferred response language as an IETF language tag; default: en-US
- `subreddit_id` string, required: 版块ID/Subreddit ID
- `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`: 2 breaking, 1 warning, 1 info
  - for the `query` request parameter `subreddit_id`, the minLength was increased from `0` to `4`
  - added the pattern `^t5_[a-z0-9]{1,17}$` to the `query` request parameter `subreddit_id`
  - for the `query` request parameter `subreddit_id`, the maxLength was set to `20`
  - added the new optional `query` request parameter `language`
- **2026-09-01** `50f9ec6e1cd3`: 2 info
  - 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`
- **2026-04-14** `ee5b7c9c88f5`: 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_subreddit_settings/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)