Upscrape 2.0 is here. Live platform data for agents, apps, and workflows. Upscrape 2.0 is here. REST API and MCP, one connection. Explore capabilities

Reddit scraper API

Read-only Reddit data: recent posts and comments from given subreddits or all of Reddit (newest first), subreddit…

Social & content 6 capabilities stable 97.4% success rate

Capabilities

Every capability is one POST /execute call that returns structured JSON.

List Comments

reddit.comments.list

Recent comments from one or more subreddits (or all of Reddit), newest first, with a cursor for the next page.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":25,"subreddits":"SaaS"},"capability":"reddit.comments.list"}'

Input

Field Type Required Description
after string optional Opaque cursor from a previous result's "next".
limit integer optional Page size, 1-100 (default 50).
subreddits string required Comma-separated subreddit names (no leading r/), or the literal "all" for all of Reddit.

Search Comments

reddit.comments.search

Search comments by query, newest first, optionally restricted to subreddits, with a cursor for the next page. Approximate; callers re-filter locally.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":25,"q":"pricing","subreddits":"SaaS"},"capability":"reddit.comments.search"}'

Input

Field Type Required Description
after string optional Opaque cursor from a previous result's "next".
limit integer optional Page size, 1-100 (default 50).
q string required Search query. Supports AND (space), OR, -term/NOT exclusion, and "exact phrase".
subreddits string optional Optional comma-separated subreddit restriction (no leading r/).

List Posts

reddit.posts.list

Recent posts from one or more subreddits (or all of Reddit), newest first, with a cursor for the next page.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":25,"subreddits":"webdev,startups"},"capability":"reddit.posts.list"}'

Input

Field Type Required Description
after string optional Opaque cursor from a previous result's "next".
limit integer optional Page size, 1-100 (default 50).
subreddits string required Comma-separated subreddit names (no leading r/), or the literal "all" for all of Reddit.

Search Posts

reddit.posts.search

Search posts by query, newest first, optionally restricted to subreddits, with a cursor for the next page.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":25,"q":"supabase alternative"},"capability":"reddit.posts.search"}'

Input

Field Type Required Description
after string optional Opaque cursor from a previous result's "next".
limit integer optional Page size, 1-100 (default 50).
q string required Search query. Supports AND (space), OR, -term/NOT exclusion, and "exact phrase".
subreddits string optional Optional comma-separated subreddit restriction (no leading r/).

Get Subreddit

reddit.subreddit.get

Fetch a single subreddit's public metadata by name.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"name":"webdev"},"capability":"reddit.subreddit.get"}'

Input

Field Type Required Description
name string required Subreddit name, without the leading r/ (case-insensitive).

Search Subreddits

reddit.subreddit.search

Search communities by name or topic (typeahead-friendly), ordered by relevance, with subscribers and description.

Request

curl -X POST https://data.upscrape.com/execute \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"limit":10,"q":"web development"},"capability":"reddit.subreddit.search"}'

Input

Field Type Required Description
limit integer optional Result count, 1-25 (default 10).
q string required Name or topic; works for short prefixes (typeahead).

Run Reddit in under a minute

Sign in, create an API key, and try any capability in the playground before you write code.

Get an API key