raw.reddit.subreddit_posts

Reddit 版块帖子

实时Beta不使用免费额度

GEThttps://api.qovia.ai/v1/raw/reddit/subreddit_posts

一个版块（subreddit）的帖子，按 hot（默认）、best、new、top、controversial 或 rising 排序，按游标翻页（第一页约 6 条，之后约 24 条）：标题、正文前 300 字、作者、发布时间（UTC）、得分、评论数、分享数、flair 和外链，记录与帖子详情相同（同一 id）。列表不带语言、作者 ID、图片和赞成率（为 null），需要时用 raw.reddit.post。广告不计入。把上一页返回的 cursor 传回即可翻页，has_more 为 false 时停止。版块不存在时返回 404，不计费。

价格: $0.001 / 次$1 / 千次 · 固定价格
计费: 成功且有结果才扣费不使用免费额度
权限: raw:redditAPI Key 需要这个 scope
限速: 仅账户限流账户每分钟上限

请求参数

作为查询参数发送

只接受下列参数，多出的参数会返回 400。

subredditstring必填

版块名（r/ 后面的部分，如 technology）

格式^[A-Za-z0-9_]{2,21}$

示例technology

sortstring · enum

排序：hot 热门（默认）、best、new 最新、top 得分最高、controversial 争议最大、rising 上升中

默认hot可选值hot · best · new · top · controversial · rising

cursorstring

取上一页响应的 cursor；第一页不传

最多 200 字格式^[A-Za-z0-9+/=_-]+$

curl 'https://api.qovia.ai/v1/raw/reddit/subreddit_posts?subreddit=technology' \
  -H "Authorization: Bearer $QOVIA_KEY"

把 $QOVIA_KEY 换成你的 API Key

示例响应200 OK

{
  "request_id": "00000000-0000-0000-0000-000000000000",
  "data": {
    "items": [
      {
        "id": "soc_red_21addc0593d8",
        "src": "social",
        "platform": "reddit",
        "lang": null,
        "text": "ELI5: The Earth and super massive impacts\nIn many simulations I’ve seen, a planet like object crashes into the early Earth. Part of it spins off losing mass from the impact and then it settles into orbit, eventually becoming the moon. However in other simulations of the earth today, if the moon or some other similarly-sized object approache",
        "author": {
          "uid_hash": "299b37f83b60",
          "followers": null,
          "nickname": "example_user_1",
          "uid": null,
          "username": "example_user_1"
        },
        "metrics": {
          "likes": 0,
          "comments": 4,
          "shares": 0
        },
        "extra": {
          "source_id": "t3_1xbu6tq",
          "title": "ELI5: The Earth and super massive impacts",
          "subreddit": "explainlikeimfive",
          "subreddit_id": null,
          "published_at": "2026-10-21T17:51:02+00:00",
          "updated_at": null,
          "content_type": "text",
          "flair": "Planetary Science",
          "nsfw": false,
          "upvote_ratio": null,
          "link_url": null,
          "images": [],
          "cover_url": null,
          "video_dur_s": null,
          "truncated": true,
          "url": "https://www.reddit.com/r/explainlikeimfive/comments/1xbu6tq/"
        },
        "prov": {
          "hash": "0xa0e9dd34d33942f1",
          "ts": "2026-10-22T03:30:00+08:00",
          "source": "live"
        }
      },
      {
        "id": "soc_red_9bc3a3b081df",
        "src": "social",
        "platform": "reddit",
        "lang": null,
        "text": "ELI5: what is a fellowship in medicine?\nbonus points if you can also explain GME and ACGME ahaha but so it’s after you graduate med school? but it’s more schooling? or it’s working as a dr?",
        "author": {
          "uid_hash": "8897faae40c1",
          "followers": null,
          "nickname": "example_user_2",
          "uid": null,
          "username": "example_user_2"
        },
        "metrics": {
          "likes": 17,
          "comments": 22,
          "shares": 2
        },
        "extra": {
          "source_id": "t3_1xbu413",
          "title": "ELI5: what is a fellowship in medicine?",
          "subreddit": "explainlikeimfive",
          "subreddit_id": null,
          "published_at": "2026-10-21T17:48:14+00:00",
          "updated_at": null,
          "content_type": "text",
          "flair": "Other",
          "nsfw": false,
          "upvote_ratio": null,
          "link_url": null,
          "images": [],
          "cover_url": null,
          "video_dur_s": null,
          "truncated": false,
          "url": "https://www.reddit.com/r/explainlikeimfive/comments/1xbu413/"
        },
        "prov": {
          "hash": "0x1a80b263f0656360",
          "ts": "2026-10-22T03:30:00+08:00",
          "source": "live"
        }
      }
    ],
    "cursor": "dDNfMXhicnFoMg==",
    "has_more": true,
    "prov": {
      "hash": "0xc85a89bc5b7f14e3",
      "ts": "2026-10-22T03:30:00+08:00",
      "source": "live"
    }
  },
  "meta": {
    "billed": true,
    "charged_usd": "0.001000",
    "used_free_quota": false,
    "free_quota_remaining": 0,
    "balance_usd": "9.999000",
    "empty": false
  }
}

目录示例，不是实时数据

响应

成功返回 HTTP 200 和统一信封：request_id、data（本接口的数据，见示例）、meta（扣费信息）。结果为空时同样是 200，meta.empty 为 true，不扣费，data 可能为空结构或 null。

响应结构详解

错误码

这个接口可能返回的错误码
code	HTTP	计费	说明
`scope_denied`	403	不扣费	这个 API Key 没有该接口需要的权限（scope）。
`endpoint_unavailable`	503	不扣费	接口暂不可用（尚未接入数据源，或价格未配置），没有执行。
`invalid_params`	400	不扣费	参数没有通过校验：缺少必填、类型或格式不对、有多余参数，或 POST 请求体不是 JSON 对象。单个参数的错误以参数名开头（`item_id: …`），缺少必填或多出参数以 `params: …` 开头。
`rate_limited`可重试	429	不扣费	超过账户每分钟请求上限（滑动 60 秒窗口），按 `Retry-After` 等待。
`too_many_unbilled`可重试	429	不扣费	最近 10 分钟打到数据源的请求里，空结果、不存在或被拒的有至少 50 次且占 80% 以上，放慢后再试。
`insufficient_balance`	402	不扣费	余额不足以支付这次调用（免费额度已用完，或接口不使用免费额度）。
`upstream_busy`可重试	503	已退款	数据源繁忙或在冷却，已退款，按 `Retry-After` 重试。
`upstream_timeout`	504	已退款	数据源超时，已退款。
`upstream_error`	502 / 503	已退款	数据源返回失败，已退款。
`upstream_rejected`	400	已退款	数据源拒绝了这组参数（格式合法但不被接受），已退款。
`not_found`	404	已退款	数据源里没有这条数据（已删除或 ID 不存在），已退款。
`reservation_expired`	504	已退款	处理时间过长，已自动退款，没有返回数据。

任何请求还可能返回认证错误：401 invalid_api_key、403 account_disabled、429 too_many_auth_failures。

全部错误码

在浏览器里直接调用

需要登录；调试台调用和 API 调用一样计费。

在调试台试用创建 API Key