SoonOne MCP server, all 49 APIs as agent tools. See how it works

Scrape any public post or subreddit feed as clean JSON

Advanced Reddit API

The Advanced Reddit API turns any public Reddit post or subreddit into structured JSON with a single GET request. Post title, body, score, comments count, author and flair, plus subreddit post feeds for discovery, scraped live with no login, OAuth app or proxies on your side.

Since Reddit locked down its official API, third-party access has meant OAuth apps, tight rate limits and per-call pricing negotiations. This Reddit scraper API works on any public post or subreddit: pass a URL with your key and get JSON back. Most requests complete synchronously in 5-45 seconds.

Free tier included, no credit card required. One key works across all 49 APIs.

At a glance
Endpoints
3
Response Time
5-45s
Data Freshness
Live

Key features

  • Any public post or subreddit, no OAuth app registration
  • Live scraping on every request, no stale cached databases
  • Post data: title, body, score, comments count, author, flair
  • Subreddit feeds for discovery with limit control (1-50)
  • fields= selection to trim responses to just what you need
  • No Reddit account, cookies or proxies required
  • Snapshot polling for slow scrapes via /v1/result

Built for

  • Brand and keyword monitoring across subreddits
  • Community sentiment and trend research
  • Content discovery pipelines for newsletters
  • Market research on niche communities
  • Datasets for LLM training and analysis

Try it

Build the request for your data

Edit the parameters below and see the exact curl command and JSON response you will get. No key required to preview.

Parameters

Request · HTTP
GET /reddit/v1/post?url=https%3A%2F%2Fwww.reddit.com%2Fr%2Fprogramming%2Fcomments%2F1abc234%2Fexample HTTP/1.1
Host: api.apicodex.io
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY
Response · JSON
200 OK
{
  "type": "post",
  "url": "https://www.reddit.com/r/programming/comments/1abc234/example",
  "data": {
    "title": "Why we moved our API gateway to the edge",
    "subreddit": "programming",
    "author": "edge_dev",
    "score": 2841,
    "upvote_ratio": 0.94,
    "comments_count": 412,
    "flair": "Discussion",
    "created_at": "2026-08-12T14:03:00Z",
    "body": "After two years on a regional cluster we moved everything to the edge..."
  }
}

Documentation

Advanced Reddit API Documentation

Pass a Reddit post or subreddit URL and get a complete, structured JSON record back in a single request. All endpoints are GET. On /v1/subreddit-posts, limit accepts 1-50 (default 10), and fields= lets you keep only the top-level fields you need. If a scrape exceeds the sync window you get HTTP 202 with a snapshot_id to resolve via /v1/result.

Base URL

url
https://api.apicodex.io/reddit

Authentication

Create a key at dash.apicodex.io and send it as an X-Api-Key header (or an ?apikey= query parameter) on every request. No Reddit account, OAuth app or session cookie is ever involved.

headers
GET /v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example
X-Api-Key: YOUR_API_KEY

Request and response

Illustrative values. Confirm current endpoint behavior, quotas, and data freshness in the API documentation before production use.

request · http
GET /v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example HTTP/1.1
Host: api.apicodex.io
X-Api-Key: YOUR_API_KEY
response · json
{
  "type": "post",
  "url": "https://www.reddit.com/r/programming/comments/1abc234/example",
  "data": {
    "title": "Why we moved our API gateway to the edge",
    "subreddit": "programming",
    "author": "edge_dev",
    "score": 2841,
    "upvote_ratio": 0.94,
    "comments_count": 412,
    "flair": "Discussion",
    "created_at": "2026-08-12T14:03:00Z",
    "body": "After two years on a regional cluster we moved everything to the edge..."
  }
}

Code examples

cURL
curl --request GET \
  --url 'https://api.apicodex.io/reddit/v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example' \
  --header 'X-Api-Key: YOUR_API_KEY'

Available Endpoints

GET /v1/post

Scrape a post by URL: title, body, score, upvote ratio, comments count, author, flair.

/v1/post?url=https://www.reddit.com/r/programming/comments/1abc234/example

GET /v1/subreddit-posts

List the current posts of a subreddit as an array for discovery, with limit control.

/v1/subreddit-posts?url=https://www.reddit.com/r/programming&limit=25

GET /v1/result

Fetch a pending result using the snapshot_id from a 202 response.

/v1/result?snapshot_id=s_abc123

Request Parameters

Required parameters

  • url Reddit URL to scrape: a post URL on /v1/post, a subreddit URL on /v1/subreddit-posts.

Optional parameters

  • fields Comma-separated top-level fields to keep, e.g. fields=title,score,comments_count. Applies to every item on list endpoints.
  • limit Max items on /v1/subreddit-posts (1-50, default 10).
  • snapshot_id /v1/result only: the id returned by a 202 response.

Pricing

Advanced Reddit API Pricing

One key, one subscription, all 49 APIs. Start free and upgrade when you grow. No minimums, no lock-in.

This API costs 25 credits per request. Credits are shared across every API on your plan.

Estimate your monthly cost

Drag the slider to match your expected request volume. We will recommend the cheapest plan that covers it.

10,000

Recommended plan

Pro

$99.99 /month

Credits used250,000
Credits included250,000
Cost per 1K requests$9.999
Choose Pro

Free

Free
1,000 credits · ~40 requests/mo · 2 rps
  • All 49 APIs included
  • No credit card required
  • Full documentation and examples
Start for free

Starter

Popular
$29.99/month
50,000 credits · ~2,000 requests/mo · 10 rps
  • All 49 APIs included
  • Email support
  • Usage dashboard and analytics
Start with Starter

Pro

$99.99/month
250,000 credits · ~10,000 requests/mo · 25 rps
  • All 49 APIs included
  • Priority support
  • Up to 5 API keys
Start with Pro

Need a different plan?

Tell us about your API, volume, or support requirements.

Contact us

Coming soon · MCP

Use the Advanced Reddit API from your AI agent

The API Codex MCP server will expose this API, and the other 39, to Claude, Cursor and any MCP client as tools. Same key, same credits, one config entry.

About the MCP server

FAQ

Frequently asked questions

The official API requires an OAuth app, enforces tight per-client rate limits and charges for meaningful volume since the 2023 pricing changes. The Advanced Reddit API is a flat scraper: pass any public post or subreddit URL with your API Codex key and get JSON back. No app registration, no OAuth, no token refresh.

No. The API only scrapes publicly visible pages and never asks for Reddit credentials, cookies or proxies. You authenticate to the API itself with your API Codex key. Private, quarantined or login-gated communities are not accessible.

Every request triggers a live scrape of the page at that moment, so scores, comment counts and subreddit feeds reflect the current state rather than a cached database. That is also why responses take 5-45 seconds instead of milliseconds: you are trading a little latency for data that is never stale.

If a scrape exceeds the synchronous window, the API returns 202 with a snapshot_id instead of making you wait on an open connection. Poll GET /v1/result?snapshot_id=... until it returns 200 with status "ready" and your data. This mostly happens on /v1/subreddit-posts, where results are typically ready within 1-2 minutes.

/v1/subreddit-posts takes a subreddit URL like https://www.reddit.com/r/programming and returns up to 50 current posts per call (limit=1-50, default 10), each with title, score, author and comments count. Feed the post URLs you find into /v1/post for the full record, and use fields= to trim each item to just what you need.