Skip to content
scrapeatlas.Dashboard

Social discussions

Reddit API

Search discussions and communities, retrieve profiles and activity, and read posts and comments.

14 endpointsx-api-key

Discover Reddit communities, search selected post, comment and media sections, read public profiles and their activity, and retrieve posts, comment threads and video transcripts.

API availability: Available

Base URL · local workerhttp://localhost:3006Public API: https://api.scrapeatlas.com.
Authenticationx-api-keyCustomer key from your account. See Authentication.

Endpoints

POST/v1/search

Search discussions

RSS keyword discovery with optional subreddit, ranking, time-window, and result bounds. Unknown scores and metrics remain null.

Reference
POST/v1/threads

Retrieve threads

Retrieve posts and nested comments from canonical HTTPS www.reddit.com post permalinks. Reaching a cap or leaving unloaded comments returns partial.

Reference
GET/v1/reddit/subreddit/details

Subreddit details

Read Reddit community metadata, rules, images, dates and weekly metrics, with null values and explicit coverage.

Reference
GET/v1/reddit/subreddit

Subreddit posts

Retrieve public subreddit posts with ranking, timeframe, after continuation and optional trimmed records.

Reference
GET/v1/reddit/subreddit/search

Subreddit search

Search post, comment and media sections together or choose the sections to retrieve, with independent continuation for each selected section.

Reference
GET/v1/reddit/post

Post details

Read a Reddit post by canonical post URL or mobile share link.

Reference
GET/v1/reddit/post/comments

Post comments

Read a Reddit post and nested comments. Pass the returned continuation with the same post URL to retrieve another comment page.

Reference
POST/v1/reddit/post/comments

Post comments with a POST body

Read a Reddit post and nested comments using JSON input, with a continuation token for further comment pages.

Reference
GET/v1/reddit/post/transcript

Post transcript

Retrieve published Reddit video captions by post, share or v.redd.it video URL, retaining raw_vtt and parsed plain text.

Reference
GET/v1/reddit/search

Global search

Search public posts or comments with ranking, optional trimmed records and after continuation.

Reference
GET/v1/reddit/subreddits/search

Community discovery

Find public communities by topic with descriptions, member counts, images and pagination.

Reference
GET/v1/reddit/profile

User profile

Retrieve a public Reddit user profile with identity, description, images, creation date and karma.

Reference
GET/v1/reddit/profile/posts

User posts

Retrieve posts published by a public Reddit account with ranking and pagination.

Reference
GET/v1/reddit/profile/comments

User comments

Retrieve comments written by a public Reddit account with post and parent identities, ranking and pagination.

Reference

Quick start

Create an API key on your account page, then call the public API. Values below are placeholders.

Terminal
curl -X POST "https://api.scrapeatlas.com/v1/search" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"meal planning","subreddits":["MealPrepSunday"],"sort":"relevance","timeWindow":"month","maxPosts":10}'

Coverage & limits

  • Search defaults to 50 posts, maximum 50. Thread requests accept at most ten permalinks.
  • Search deadline: 25 seconds. Thread deadline: 140 seconds. Readiness requires a configured proxy and Chromium.
  • Routes, authentication header, environment names and port are stable.
  • The worker is stateless. Product-specific research, billing, and presentation remain with the consumer.
  • Expanded routes: 45-second deadline, at most six document/caption attempts including one shared transient retry, 8 MiB decoded responses, 50,000 JSON nodes and depth 32.
  • RSS and caption reads negotiate gzip, deflate and Brotli; the same byte budget applies to the compressed stream and to the decoded body.
  • Expanded routes share the existing admission queue. Browser operations use a fresh logged-out proxied Patchright context; captions and community/profile JSON reads use bounded proxied HTTPS.
  • Public-card fields and ranking are returned as Reddit serves them.
Error codes
6
HTTPfailure.codeMeaning
400invalid_requestThe request failed validation.
401invalid_requestThe internal service secret is invalid.
503upstream_error breaker_openProxy unavailable or thread retrieval temporarily paused.
502upstream_errorRetrieval failed.
504timeoutThe deadline expired; available results are retained.
200partial challengedInspect status and failure even when HTTP succeeds.