TItikhub
Reddit-APP-API

获取Reddit APP版块Feed内容/Fetch Reddit APP Subreddit Feed

Changed on

[中文]

用途:

  • 获取指定Reddit版块的Feed内容流,展示该版块的帖子列表

参数:

  • subreddit_name: 版块名称(不带r/前缀),如"pics", "funny"等
  • sort: 排序方式,可选: BEST(最佳), HOT(热门), NEW(最新), TOP(顶级), CONTROVERSIAL(有争议), RISING(上升中)
  • filter_posts: 过滤掉指定的帖子ID列表
  • after: 分页参数,获取下一页时使用

返回:

  • 版块Feed JSON数据,包含:
    • 该版块的帖子列表
    • 帖子详细信息
    • 版块元数据
    • 分页信息

[English]

Purpose:

  • Fetch feed content stream of a specified Reddit subreddit, displaying the post list of that subreddit

Parameters:

  • subreddit_name: Subreddit name (without r/ prefix), e.g., "pics", "funny"
  • sort: Sort method, options: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING
  • filter_posts: List of post IDs to filter out
  • after: Pagination parameter for fetching next page

Returns:

  • JSON data of subreddit feed containing:
    • List of posts in the subreddit
    • Detailed post information
    • Subreddit metadata
    • Pagination information

[示例/Example]

subreddit_name="AskReddit" sort="HOT" filter_posts=[] after="" need_format=false

get/api/v1/reddit/app/fetch_subreddit_feed

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

languagestring

返回内容使用的语言，采用 IETF 语言标签；默认 en-US / Preferred response language as an IETF language tag; default: en-US

subreddit_namestring required

版块名称/Subreddit name

sort'BEST' | 'HOT' | 'NEW' | 'TOP' | 'CONTROVERSIAL' | 'RISING'

排序方式/Sort method: BEST, HOT, NEW, TOP, CONTROVERSIAL, RISING

filter_postsstring[]

过滤帖子ID列表/Filter post IDs

afterstring

分页参数/Pagination parameter

need_formatboolean

是否需要清洗数据/Whether to clean and format the data

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

  • 96a122a5f220Revision changes
    • info

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

    • info

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

  • eab99e8bfe5bRevision changes
    • breaking

      the query request parameter sort was restricted to a list of enum values

    • breaking

      for the query request parameter subreddit_name, the minLength was increased from 0 to 2

    • breaking

      added the pattern ^[A-Za-z0-9_]+$ to the query request parameter subreddit_name

    • warning

      for the query request parameter after, the maxLength was set to 4096

    • warning

      for the query request parameter subreddit_name, the maxLength was set to 21

    • warning

      for the query request parameter filter_posts, the type of property items/ changed from no type to string

    • info

      added the new optional query request parameter language

    • info

      added the new enum value BEST to the query request parameter sort

    • info

      added the new enum value CONTROVERSIAL to the query request parameter sort

    • info

      added the new enum value HOT to the query request parameter sort

    • info

      added the new enum value NEW to the query request parameter sort

    • info

      added the new enum value RISING to the query request parameter sort

    • info

      added the new enum value TOP to the query request parameter sort