Reddit API

也叫红迪

11 个接口读 Reddit:帖子、用户、社区、热榜。一次 $0.0020 起。不用登录 Reddit,不用 Cookie;失败不收费。

接口11 个接口分 4 组,同一种返回格式
价格$0.0020 起约 ¥0.01一次。失败不收费
近 30 天可用99.9% 在线 · 接口在接调用的时间占比
数据当场取榜单是 10 分钟一次的快照

调一次,拿回来的样子

录下来的真实返回,字段已经整理好,直接给 AI 或表格用。
真实返回
GET/v1/reddit/posts/search$0.0020
字段值
typeimage
langen
published_at2024-11-22 01:25 UTC
metrics.comments213
is_pinnedfalse

2026-10-12 18:43 UTC 录下的真实返回,这里是前 5 行。

在 Playground 里跑一次 · $0.0020
录制的返回
{
  "code": "ok",
  "request_id": "e5368130-2302-4850-b4a8-c7eb44f93554",
  "data": {
    "items": [
      {
        "id": "t3_c6zfcsj",
        "url": "https://www.reddit.com/r/hiking/comments/c6zfcsj/",
        "type": "image",
        "title": "Everything I pack for saturn rings",
        "text": null,
        "lang": "en",
        "published_at": "2024-11-22T01:25:15.633Z",
        "author": {
          "id": "t2_ulkupadj",
          "username": "maya_makes",
          "avatar_url": "https://styles.redditmedia.com/t5_7z4w4c/styles/profileIcon_giouwc19cllx7.png"
        },
        "metrics": { "comments": 213 },
        "images": ["https://i.redd.it/lmqqmsves43vx.jpeg"],
        "is_pinned": false
      },
      // … 另有 6 条
    ]
  },
  "page": {
    "next_cursor": "c1.QZa1D_DF2UeCuT2KXm3EnAtguUJjsyD68oCTkkOq",
    "cursor_expires_at": "2026-10-12T19:43:12.000Z",
    "has_more": true,
    "returned": 7
  },
  "warnings": [],
  "meta": {
    "capability": "reddit.posts.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T18:43:12.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "metrics.likes": "platform",
      "metrics.favorites": "platform",
      "metrics.views": "capability",
      "metrics.reposts": "platform",
      "author.name": "platform",
      "author.verified": "capability",
      "author.followers": "capability",
      "hashtags": "platform",
      "mentions": "capability",
      "post_id": "platform",
      "parent_id": "platform",
      "root_id": "platform",
      "metrics.shares": "capability"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

取自 2026-10-12 18:43 UTC 录下的真实返回。名字、正文和编号是示例,链接也是,都不是录到的原文(页面不展示任何人的个人信息);数字是原样。长列表做了截断。请求号、游标和余额是示意。

能拿到什么

每一行是一个接口:返回什么,一次多少钱。

接口路径返回价格
帖子5
Reddit 帖子搜索GET/v1/reddit/posts/search内容列表$0.0020
Reddit 帖子详情GET/v1/reddit/posts/get内容$0.0020
Reddit 视频字幕GET/v1/reddit/posts/transcript/get逐字稿$0.0020
Reddit 帖子评论GET/v1/reddit/posts/comments/list评论列表$0.0020
Reddit 热门帖子GET/v1/reddit/posts/trending内容列表$0.0020
用户3
Reddit 用户资料GET/v1/reddit/users/get账号$0.0020
Reddit 用户帖子GET/v1/reddit/users/posts/list内容列表$0.0020
Reddit 用户活跃社区GET/v1/reddit/users/subreddits/list社区列表$0.0020
社区2
Reddit 社区资料GET/v1/reddit/subreddits/get社区$0.0020
Reddit 社区帖子GET/v1/reddit/subreddits/posts/list内容列表$0.0020
Reddit 趋势搜索词GET/v1/reddit/trends/list热点列表$0.0020
价格是现行价格。失败和结果不确定的调用不收费。Reddit API 价格 →在 AI 里用 Reddit 数据 →看实时状态 →

大家拿它做什么

你的 AI 现在就能用 Reddit 数据跑的现成任务。每个任务是几次调用,带花费上限。

在 Claude、Cursor 里直接问 Reddit

加上 DataXAPI 的 MCP,AI 会自己找到合适的 Reddit 接口去调,回答里带原始链接。花多少钱按调了哪些接口算。

https://api.dataxapi.com/mcp

三步开始

这里演示的是 Reddit 帖子搜索。Reddit 的其他接口都是同样的调法,返回同样的格式。

拿一把 Key

用邮箱验证码或 Google 登录。可免费试用,不用绑卡。

自己调,或者让你的 AI 调

代码里一次 GET。或者把下面这段话带着你的 Key 贴给你的 agent:它自己接好,然后能自己找到并调用这些接口。

读 https://dataxapi.com/agents.md,在这个 agent 里帮我接好 DataXAPI。我的 API Key 是 dx_live_…,之后所有 DataXAPI 的调用都用它。

登录后复制,带上你的 Key

每次读到的都是同一种格式

数据在 data.items(单个对象在 data.item),下一页在 page.next_cursor,扣了多少在 meta.billing.amount。失败不扣费。

看快速开始 →
curl -G "https://api.dataxapi.com/v1/reddit/posts/search" \
  --data-urlencode "query=saturn rings" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
# pip install dataxapi
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.reddit.posts.search(query="saturn rings")
print(result["data"]["items"])
// npm i @dataxapi/sdk
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.reddit.posts.search({ query: "saturn rings" });
console.log(result.data.items);
dataxapi call reddit.posts.search 'query=saturn rings'
{
  "mcpServers": {
    "dataxapi": {
      "type": "http",
      "url": "https://api.dataxapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${DATAXAPI_API_KEY}"
      }
    }
  }
}

把这段加进你的 MCP 客户端,然后让你的 AI 调用 reddit.posts.search。

边界情况

Reddit 这些接口在边界上怎么表现,以及调用结果不对时先看哪里。

每页条数
列表每页 6 到 500 条,各接口不同。7 个列表里有 5 个能翻页:把 page.next_cursor 作为 cursor 传回,每一页是一次单独的调用。其余只有一页。
给不了的字段
11 个接口里有 9 个填不满它返回的对象。每个接口的页面列出了给不了哪些,每次返回也在 meta.unavailable 里再写一遍:缺的字段不会被悄悄写成 0。
对象不存在时读起来像空结果
Reddit 社区帖子:对象不存在和对象下面没有东西分不出来,所以返回空结果而不是 404,并按空结果计费。
预览结构
有 2 个接口返回的是预览结构,字段还可能调整;其余返回统一的结构,所有平台都一样。
快照
Reddit 趋势搜索词:榜单是每 10 分钟刷新一次的快照,meta.fetched_at 写明是什么时候取的。
帖子编号带 t3_
帖子编号要带 t3_ 前缀,也可以直接传帖子链接(reddit.com/r/社区/comments/编号/)。
评论一页页取
一页是几条一级评论,连着它们的前几层回复;游标取的是下一批一级评论。Reddit 折叠起来的更深的回复不展开。
还没公开的分数
Reddit 还在隐藏分数的评论,分数返回 null,不是 1。
社区和用户都用名字
社区用不带 r/ 的社区名,用户用不带 u/ 的用户名。不存在的社区取帖子返回空列表,按空结果计费。
只有 Reddit 托管的视频
只有 Reddit 自己托管并生成了字幕的视频才有文字稿。从别的网站嵌入的视频、没有字幕的视频,都按不存在返回,不扣费。

关于 Reddit API 的常见问题

回答从简,细节在各接口的页面。

Reddit API 怎么收费?

按次收费,没有订阅。11 个接口都是一次 $0.0020。拿到数据才扣费,失败不收。

需要 Reddit 账号或 Cookie 吗?

不需要。你只拿一把 DataXAPI 的 Key:不用登录 Reddit,不用 Cookie,也不用养设备。接口只返回公开可见的数据。

数据是实时的吗?

每次调用都当场去 Reddit 取,meta.fetched_at 写明取到的时间。Reddit 趋势搜索词:榜单是每 10 分钟刷新一次的快照。结果保留 24 小时,带同一个 Idempotency-Key 重试不会再扣一次。

空结果收费吗?

列表返回空结果时照价收费:搜索已经执行了。读单个对象而对象不存在时返回 not_found,收不收费看接口页。

Reddit 改版了怎么办?

调用失败不管什么原因都不扣费。被暂停的接口返回 capability_paused,同样不扣费;GET /v1/catalog/status 写着现在哪些能用。

相关

一把 Key 调 Reddit。

免费试用:按 $0.0020 一次,最多可调 50 次,不用绑卡。 不用登录 Reddit,不用 Cookie,没有订阅。失败不收费。

免费开始