Community trend research
Use Reddit endpoints to turn community trend research into repeatable API requests with documented inputs and JSON responses.
Turn public Reddit discussions into structured inputs for community research, brand monitoring, product intelligence, and AI-agent context.
Search public Reddit posts, inspect subreddit feeds, and fetch public post and comment data through documented Crawlora API endpoints.
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
Search public Reddit posts, inspect subreddit feeds, and fetch public post and comment data through documented Crawlora API endpoints.
Use Reddit endpoints to turn community trend research into repeatable API requests with documented inputs and JSON responses.
Use Reddit endpoints to turn brand and product monitoring into repeatable API requests with documented inputs and JSON responses.
Use Reddit endpoints to turn public discussion analysis 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.
Sampled 14 Oct 2026: 20 items, 11 fields filled in every item. created_utc: 2025-05-04 to 2026-10-04; url: reddit.com.
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.
Sampled 14 Oct 2026: 20 items, 11 fields filled in every item. created_utc: 2026-09-03 to 2026-10-13; url: reddit.com.
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.
Sampled 14 Oct 2026: 25 of 25 fields returned with a value. post.created_utc: 2026-07-28; post.score: 17,312.
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.
Sampled 14 Oct 2026: 3 items, 10 fields filled in every item, 1 not. created_utc: 2026-05-22; score: 2 to 8, median 2.
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.
Sampled 14 Oct 2026: 20 items, 11 fields filled in every item. created_utc: 2026-10-06 to 2026-10-10; url: reddit.com.
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.
Sampled 14 Oct 2026: 1 item, 7 fields filled in every item. created: 2026-09-30; permalink: reddit.com.
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.
Sampled 14 Oct 2026: 20 items, 11 fields filled in every item. created_utc: 2026-09-03 to 2026-10-13; url: reddit.com.
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.
Sampled 14 Oct 2026: 20 items, 8 fields filled in every item. created_utc: 2026-10-13; permalink: reddit.com.
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.
Sampled 14 Oct 2026: 20 items, 11 fields filled in every item. created_utc: 2026-10-12 to 2026-10-13; url: reddit.com.
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.
Sampled 14 Oct 2026: 20 items, 11 fields filled in every item. created_utc: 2026-10-13; url: reddit.com.
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.
Sampled 14 Oct 2026: 20 items, 8 fields filled in every item. created_utc: 2021-12-06 to 2025-06-11; permalink: reddit.com.
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.
Sampled 14 Oct 2026: 20 items, 11 fields filled in every item. created_utc: 2021-12-12 to 2026-04-03; url: reddit.com.
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 throws a bot-verification wall at naive scrapers. Crawlora's Reddit endpoints return public subreddit, post, comment, and search data as structured JSON.
A subreddit feed, a single post, a post's comment tree, or a keyword search across Reddit.
Pass the subreddit, post URL, or query to Crawlora's Reddit endpoint — no OAuth app to register.
Receive post title, score, author, flair, and comment threads, plus subreddit about data, as clean JSON.
Re-run on a schedule to track brand mentions, sentiment, and trending discussions.
Client libraries
Install the dedicated Reddit client for your language. Each package covers the Reddit endpoints on this page and calls Crawlora's hosted API with your API key.
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/redditPackagistFAQ
Send a subreddit, post URL, or search query to Crawlora's Reddit endpoint and get structured JSON — titles, scores, authors, comment threads, subreddit metadata — without registering an OAuth app or hitting rate caps. Collect public data and respect Reddit's terms.
Reddit shows a bot-verification wall to unauthenticated requests. Crawlora's managed execution returns public posts and comments instead of the challenge, without accessing private subreddits or any logged-in data.
Collecting publicly accessible posts and comments is generally permissible if you respect Reddit's terms of use, robots directives, rate limits, and applicable law. This is for public data you're authorized to collect.
Reddit's commercial API costs $0.24 per 1,000 calls with a $12,000/year minimum commitment, and free-tier self-serve registration is closed — new OAuth apps need manual approval that can take 2-4 weeks. Crawlora returns the same public posts, comments, and subreddit data with one API key and no approval wait.