Capabilities
Every capability is one POST /execute
call that returns structured JSON.
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 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/).
|
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 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