Reddit-APP-API

批量获取Reddit帖子详情(最多5条)/Fetch Reddit Post Details in Batch (Max 5)

Changed on

[中文]

用途:

  • 根据帖子ID列表批量获取帖子详情
  • 支持最多5条帖子的批量查询
  • 可选择性包含特定评论的上下文

参数:

  • post_ids: 帖子ID列表,逗号分隔,格式如 "t3_XXXXXX,t3_YYYYYY",最多支持5条
  • include_comment_id: 是否包含特定评论ID,默认False
  • comment_id: 评论ID(当include_comment_id为True时使用),格式如 "t1_XXXXXX"

返回:

  • 包含帖子详细信息的数据,包括:
    • 帖子内容、标题、作者
    • 统计数据(点赞数、评论数等)
    • 版块信息
    • 奖励信息
    • 媒体资源
    • 推荐原因等

注意:

  • 最多支持5条帖子的批量查询
  • 超过5条将返回错误
  • APP接口的ID格式与Web接口不同,需要添加类型前缀
  • 帖子ID前缀: t3_ (例如: t3_1ojnh50)
  • 评论ID前缀: t1_ (例如: t1_abcd123)

[English]

Purpose:

  • Fetch post details in batch by post ID list
  • Support batch query for up to 5 posts
  • Optionally include context for specific comments

Parameters:

  • post_ids: Post IDs comma-separated, format like "t3_XXXXXX,t3_YYYYYY", max 5 posts
  • include_comment_id: Whether to include specific comment ID, default False
  • comment_id: Comment ID (used when include_comment_id is True), format like "t1_XXXXXX"

Returns:

  • Data containing detailed post information including:
    • Post content, title, author
    • Statistics (upvotes, comment count, etc.)
    • Subreddit information
    • Award information
    • Media resources
    • Recommendation reasons, etc.

Notes:

  • Maximum 5 posts per batch query
  • Error will be returned if exceeds 5 posts
  • APP API ID format differs from Web API, requires type prefix
  • Post ID prefix: t3_ (e.g., t3_1ojnh50)
  • Comment ID prefix: t1_ (e.g., t1_abcd123)

[示例/Example]

post_ids="t3_1ojnh50,t3_1ok432f,t3_1nwil8j" include_comment_id=false comment_id="" need_format=false

get/api/v1/reddit/app/fetch_post_details_batch

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

post_idsstring required

帖子ID列表,逗号分隔,最多5条/Post IDs comma-separated, max 5

include_comment_idboolean

是否包含特定评论ID/Include specific comment ID

comment_idstring

评论ID/Comment ID (when include_comment_id is True)

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

    • info

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

    • info

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

    • breaking

      for the query request parameter post_ids, the minLength was increased from 0 to 4

    • breaking

      added the pattern ^(?:|t1_[a-z0-9]{1,17})$ to the query request parameter comment_id

    • breaking

      added the pattern ^t3_[a-z0-9]{1,17}(?:\s*,\s*t3_[a-z0-9]{1,17})*$ to the query request parameter post_ids

    • warning

      for the query request parameter comment_id, the maxLength was set to 20

    • warning

      for the query request parameter post_ids, the maxLength was set to 104

    • info

      added the new optional query request parameter language