社区趋势研究
Use Reddit endpoints to turn 社区趋势研究 into repeatable API requests with documented inputs and JSON responses.
将公开的 Reddit 讨论转化为结构化数据，用于社区研究、品牌监控、产品情报和 AI 智能体的背景信息。
通过文档化的 Crawlora API 端点搜索公开的 Reddit 帖子、查看子版块信息流，并获取公开的帖子和评论数据。
Endpoint families
6
Documented params
62
Examples
12
Live catalog snapshot
Active endpoints
12
Methods
GET
Required params
23
Schema refs
12
{
"platform": "Reddit",
"endpoint": "reddit-search",
"method": "GET",
"path": "/reddit/search",
"auth": "apiKey"
}Related use cases
Free tools
Use cases
通过文档化的 Crawlora API 端点搜索公开的 Reddit 帖子、查看子版块信息流，并获取公开的帖子和评论数据。
Use Reddit endpoints to turn 社区趋势研究 into repeatable API requests with documented inputs and JSON responses.
Use Reddit endpoints to turn 品牌和产品监控 into repeatable API requests with documented inputs and JSON responses.
Use Reddit endpoints to turn 公开讨论分析 into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live Reddit endpoint catalog — 12 endpoints, 62 documented request parameters, and 12 published response schemas — the same catalog Docs and Playground run against.
12 documented Reddit endpoints, grouped into 9 request families — Subreddit, User and Comments, plus 6 more.
62 request parameters are documented across those Reddit endpoints, 23 of them required — the full input contract is public before you write any integration code.
12 of the 12 Reddit endpoints ship a recorded example response, and 12 carry a documented response schema — you can code against the real JSON before the first request.
Reddit endpoints document their error responses (400, 404, 429 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
12 hosted MCP tools back the Reddit endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/reddit/subreddit/{subreddit}/posts
/reddit/user/{username}/comments
/reddit/comments/{id}
/reddit/domain/{domain}/posts
/reddit/leads
/reddit/post/{id}
Endpoint catalog
/reddit/searchSearches public Reddit content and returns public post entries. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_search
/reddit/subreddit/{subreddit}/postsReturns public posts from a subreddit. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_subreddit_posts
/reddit/post/{id}Returns a public Reddit post. The default mode is 1 credit. Set `include_metrics=true` to return public net score, upvote ratio, comment count, award count, and estimated upvote/downvote totals for 3 credits. Reddit fuzzes voting data, so estimates are approximate; share, repost/crosspost, and view counts are not exposed anonymously. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_post
/reddit/comments/{id}Returns a Reddit post with its public comments. The default mode is 1 credit. Set `include_metrics=true` to return the comments with public net score and award count plus post engagement metrics for 3 credits. Large threads may expose only an initial comment subset. Reddit does not expose per-comment upvote ratios or exact upvote/downvote totals anonymously. A post that exists but has no comments yet returns a 200 response with an empty comments list; a post that does not exist returns 404, and a temporary block or upstream failure returns 503 (retryable) rather than 404. If source.type is redlib, public fields and credit weights are preserved.
Response notes
Redlib comment fallback preserves flat entries with actual `parent_id` and `depth`, caps the total returned comments at `limit`, and returns the bounded upstream subset without expanding `more` nodes. When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_comments
/reddit/domain/{domain}/postsReturns public posts submitted from a linked domain. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_domain_posts
/reddit/leadsScans a Reddit search page for people actively asking for a product or service, scores each post 0-10 for buying intent, and returns them ranked highest-first with the signals that fired. Self-promotion, hiring posts, freelancer service adverts, revenue-milestone posts, duplicate reposts, and Title Case article headlines are filtered out before scoring. A deterministic prefilter always runs; when `classifier` resolves to `llm` the surviving candidates are additionally refined in one batched model call. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. The lead-response fields and credit weights are preserved regardless of the underlying Reddit data source.
Response notes
Provider configuration: the model pass resolves its base URL from `REDDIT_LEADS_LLM_BASE`, then the shared `OPENAI_API_BASE`, `OPENAI_BASE_URL`, or `OPENAI_API_BASE_URL`, then `https://api.openai.com/v1`. It also reads `REDDIT_LEADS_LLM_MODEL` (defaults to `gpt-5.4`) and `REDDIT_LEADS_LLM_KEY` (falls back to `OPENAI_API_KEY`). Set `REDDIT_LEADS_LLM_BASE` to route this endpoint to a different provider than the rest of the deployment. Lead search uses the same internal Redlib fallback when its native Reddit search fails. The lead response keeps its existing fields, funnel stats and credit weights; it does not add a public `source` field. Temporary provider, authentication, rate-limit and parser failures return `503`. Provider selection is server configuration.
MCP tool reddit_leads
/reddit/subreddit/{subreddit}/aboutReturns public metadata and sample posts for a subreddit. Subscriber counts, icons, and banners are omitted because they are not available on anonymous Reddit pages. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
Redlib community metadata comes from the public JSON about response plus a bounded sample listing. `feed_url` is empty for this provider; it is not an feed. When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_subreddit_about
/reddit/subreddit/{subreddit}/commentsReturns flat public comment entries from a subreddit latest-comments feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_subreddit_comments
/reddit/subreddits/postsReturns public posts from a combined multi-subreddit feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_subreddits_posts
/reddit/trendsReturns public posts from broad Reddit hot, new, rising, or top feeds. For subreddit-specific trends, use `/reddit/subreddit/{subreddit}/posts` with `sort=hot`, `sort=new`, `sort=rising`, or `sort=top`. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_trends
/reddit/user/{username}/commentsReturns flat public comment entries from a public Reddit user's comments feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_user_comments
/reddit/user/{username}/postsReturns public posts from a public Reddit user's submitted feed. A `503` with a `Retry-After` header means Reddit is temporarily throttling the request; wait that many seconds and retry. If source.type is redlib, public fields and credit weights are preserved.
Response notes
When the native Reddit source fails, the service can use the internal Redlib provider. Fallback responses retain the same fields and credit weights and report `source.type=redlib` with a public Reddit URL. Listing cursors use the upstream JSON cursor; results remain bounded by `limit`. Temporary provider, authentication, rate-limit and parser failures return `503`, while confirmed missing resources return `404`. Provider selection is server configuration.
MCP tool reddit_user_posts
Related APIs
Social & Creator Platforms
Build creator intelligence, video research, transcript, and audience-comment workflows without maintaining YouTube scrapers.
Social & Creator Platforms
Turn Twitch's public channel, stream, clip, and team data into structured JSON — live status and viewer counts, top games, clips, VODs, and team rosters — as normalized JSON. Credential-free.
Social & Creator Platforms
Track creator and video activity, discover sounds and LIVE streams, and study public ad creatives through documented TikTok API routes.
Company coverage
Reddit, Inc. · RDDT
Reddit is operated by Reddit, Inc. (RDDT). Crawlora's SEC endpoints take the same company's CIK, so filings, financials, insider transactions and 13F holdings come from the same API key as the Reddit endpoints above.
SEC filings & financials API →How to scrape Reddit
Reddit 会对朴素的抓取工具设置机器人验证墙。Crawlora 的 Reddit 端点将公开的子版块、帖子、评论和搜索数据返回为结构化 JSON。
某个子版块信息流、单条帖子、某条帖子的评论树，或跨 Reddit 的关键词搜索。
将子版块、帖子 URL 或查询词传给 Crawlora 的 Reddit 端点——无需注册 OAuth 应用。
获取帖子标题、得分、作者、flair 和评论线程，以及子版块的 about 数据，均为整洁的 JSON。
定期重新运行以跟踪品牌提及、情绪和热门讨论。
客户端库
为你的语言安装 Reddit 专用客户端。每个包都覆盖本页的 Reddit 端点，并使用你的 API 密钥调用 Crawlora 托管 API。
npm install @crawlora-org/redditnpmpip install crawlora-redditPyPIgo get github.com/Crawlora-org/crawlora-redditpkg.go.devgem install crawlora-redditRubyGemsnet.crawlora:crawlora-redditMaven Centralcomposer require crawlora/redditPackagistcargo add crawlora-redditcrates.ioFAQ
将子版块、帖子 URL 或搜索查询发送给 Crawlora 的 Reddit 端点，即可获得结构化 JSON——标题、得分、作者、评论线程、子版块元数据——无需注册 OAuth 应用，也不会触及速率上限。请采集公开数据并遵守 Reddit 的条款。
Reddit 会对未认证的请求显示机器人验证墙。Crawlora 的托管执行返回的是公开的帖子和评论，而不是验证挑战，且不会访问私密子版块或任何登录后的数据。
在遵守 Reddit 使用条款、robots 指令、速率限制和适用法律的前提下，采集公开可访问的帖子和评论通常是被允许的。这适用于你有权采集的公开数据。
Reddit 的商业 API 每 1000 次调用收费 0.24 美元，且有每年 12000 美元的最低承诺，免费自助注册通道也已关闭——新的 OAuth 应用需要人工审批，可能需要 2-4 周。Crawlora 用一个 API 密钥即可返回相同的公开帖子、评论和子版块数据，且无需等待审批。