Reddit comments API

A Reddit comments API that takes one post URL and returns its public discussion as rows: author, full text, score, timestamp, and — because a thread is a tree — the depth and parent id that let you rebuild it. The OP's own comments, moderator comments and pinned comments arrive flagged, so the signal survives the flattening.

By Aldo Morese, founder of QuanticData · Published Aug 21, 2026 · Updated Sep 3, 2026

Get my free API key See the request

$0.002 per delivered comment · $2 free every month · Failed runs never billed

POST /v1/scraper/collectors/reddit_comments/run

$ curl $QD/reddit_comments/run \
    -H "Authorization: Bearer $QD_API_KEY" \
    -d '{"post": "https: //www.reddit.com/r/pics/comments/92dd8/test_post_please_ignore/", "sort": "top", "max_results": 50}'
{ "status": "done", "count": 50,
  "results": [
    {
      "id": "…",
      "parent_id": "…",
      "depth": …,
      "author": "…" } ],
  "cost": 0.1 }
# 50 comments × $0.002 · nothing delivered, nothing charged

Reddit comments API: post and sort in, a residential exit in the middle, delivered rows with rank, id and parent_id on the right, $0.002 per comment. — You send post and sort; the run goes out through a residential exit and comes back as comments with rank, id and parent_id — 14 fields on every row — and you are billed $0.002 for each comment actually delivered, nothing for a run that delivers none.

$0.002 / comment1,000 comments on the free $2 every month

Semantic inputpost, sort, country — no URL lists

Up to 200comments per run, pagination handled for you

No browserread over HTTP/TLS — cheaper and faster than rendering

Try it

Reddit comments, running now

Change the input and run it against the live collector — nothing to install, no sign-up.

Run it from your own code, on your own inputs

Same collector, same rows — $2 of free API credit every month, no card.

Get my free API key

What a Reddit comments API does

Comment data is where Reddit's value actually lives: the post is a headline, the thread is the opinion. One run loads up to two hundred comments of a public post in thread order for the sort you choose — top for consensus, new for live monitoring, controversial for the disagreements — with the branches Reddit did not load counted honestly in the run notes rather than silently missing.

Every row carries parent_id and depth, which is the difference between a bag of sentences and a conversation: replies stay attached to what they answer, sentiment can be weighted by depth or score, and quoting a comment links straight to its permalink. Pairs naturally with the Reddit posts collector — discover threads by keyword there, pull the discussions here.

Limits, in plain numbers

Everything that bounds one run of this collector. No hidden throttles.

Max per run

200 comments

Price

$0.002 / comment

Per 1,000

$2.00

Failed runs

Free zero rows, zero charge

Free every month

$2 no card

Rate limit

60 req/min on the free tier

What one comment looks like

Every delivered comment carries these fields. Nullable means the source did not publish it — the field stays empty instead of being guessed.

Field	Type	What it holds
`rank`	integer	1-based position in thread order for the chosen sort.
`id`	string · nullable	Comment fullname (t1_…).
`parent_id`	string · nullable	Parent comment fullname; null for top-level comments.
`depth`	integer	0 for top-level, +1 per nesting level.
`author`	string · nullable	Comment author.
`body`	string · nullable	Comment text (markdown rendered to plain text).
`score`	integer · nullable	Net upvotes as shown.
`created_at`	string · nullable	Comment timestamp (ISO 8601).
`edited`	boolean	True when the comment was edited.
`permalink`	string · nullable	Direct link to the comment.
`is_submitter`	boolean	True when the author is the post's OP.
`is_moderator`	boolean	True when the author is a subreddit moderator.
`stickied`	boolean	True for pinned comments.
`collapsed`	boolean	True when Reddit collapses the comment by default.

Inputs

The whole request. Anything you leave out falls back to the default shown in the catalog.

Input	Type	Required	What it does
`post`	string	yes	Post URL or id, e.g. https://www.reddit.com/r/pics/comments/92dd8/… or 92dd8.
`sort`	string	no	Comment order (default top). One of: `top`, `new`, `controversial`, `old`, `qa`.
`country`	string	no	ISO 3166-1 alpha-2 code — proxy exit geo. Omit for the default pool.
`max_results`	integer	no	How many comments to deliver at most (1–200). You pay only for delivered comments.

Pricing

Reddit comments API pricing

$0.002 per delivered comment. A run that delivers nothing costs nothing: blocked pages, challenges and retries are on us, and the $2 monthly allowance covers about 1,000 comments before you spend anything.

$0.002per delivered comment$2 per 1,000 delivered comments

1,000 commentson the free allowance$2 every month, no card

Zero rowszero chargeblocks, captchas and retries are on us

−30%on volume tiersthe catalog returns your key's price

Pay as you go

$0/mo

$2 free credit / month
60 requests / min
List unit prices

Starter

$19/mo

$15 free credit / month
300 requests / min
10% off unit prices

Growth

$79/mo

$50 free credit / month
600 requests / min
20% off unit prices

Scale

$299/mo

$250 free credit / month
1,200 requests / min
30% off unit prices

Same wallet, same key and same $2 monthly allowance as every other Data API. Prices are launch pricing read live from the billing config — GET /v1/scraper/collectors returns the price your key actually pays.

Integration

One POST, typed rows

Base URL https://api.quanticdata.io/v1, Bearer auth, the same key as every other Data API. Endpoint: POST /v1/scraper/collectors/reddit_comments/run.

curl -X POST https://api.quanticdata.io/v1/scraper/collectors/reddit_comments/run \
  -H "Authorization: Bearer $QD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post":"https://www.reddit.com/r/pics/comments/92dd8/test_post_please_ignore/","sort":"top","max_results":50}'

import requests

r = requests.post(
    "https://api.quanticdata.io/v1/scraper/collectors/reddit_comments/run",
    headers={"Authorization": f"Bearer {QD_API_KEY}"},
    json={
        "post": "https://www.reddit.com/r/pics/comments/92dd8/test_post_please_ignore/",
        "sort": "top",
        "max_results": 50
    },
    timeout=120,
)
for row in r.json()["payload"]["results"]:
    print(row)

const res = await fetch(
  "https://api.quanticdata.io/v1/scraper/collectors/reddit_comments/run",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.QD_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"post":"https://www.reddit.com/r/pics/comments/92dd8/test_post_please_ignore/","sort":"top","max_results":50}),
  },
);
const { payload } = await res.json();
console.table(payload.results);

claude mcp add quanticdata \
  -e QUANTICDATA_API_KEY=qd_live_your_key_here \
  -- npx -y quanticdata-mcp

# then, in the chat:
> run the reddit_comments collector with post="https://www.reddit.com/r/pics/comments/92dd8/test_post_please_ignore/" and sort="top"

What people build with the Reddit comments API

Three shapes of work this endpoint was designed around.

Opinion mining at thread level

Pull the top-sorted tree of the threads that mention your product and you have ranked, scored consumer language — the phrasing customers actually use, ready for an LLM or a tagging pass.

Community research

The depth and parent columns preserve who-answered-whom, so argument chains and consensus points survive into the dataset instead of collapsing into isolated quotes.

Live thread monitoring

Sort new and re-run on a schedule: fresh comments append by id, and the stickied/moderator flags separate announcements from the crowd.

Reddit comments API versus rolling your own

The differences that actually cost time when you build this in-house.

	DIY scraper	This collector
Tree structure	Lost, or rebuilt by you from nested JSON	depth + parent_id on every row, ready to rebuild
Login / API app	OAuth app, tokens, rate-limit bookkeeping	None — public posts, metered on your QuanticData key
Deep branches	Silently absent	Counted in the run notes, so coverage is explicit

Reddit comments API: the POST to /v1/scraper/collectors/reddit_comments/run with post and sort on the left, and the JSON envelope on the right with 50 comments and usage.cost_usd $0.10. — The same call you would paste into a terminal: a Bearer key, post, sort and country in the body, and back the envelope every QuanticData endpoint returns — type, message, payload — where count is how many comments arrived and usage.cost_usd is $0.10, which is 50 × $0.002. A run that delivers nothing costs nothing. The key is good for 60 req/min on the free tier.

Sources and standards

The platform documentation and standards this collector is built against — check any claim on this page against the primary source:

FAQ

Questions we get about the Reddit comments API.

Something else? Ask us →

How many comments does one run return?

Up to 200 per run. Reddit loads roughly the first 500 comments of a thread in one page; the collector delivers them in thread order up to your max_results and reports any "load more" branches it did not expand in the notes — you always know what a run covered.

Can I rebuild the exact thread structure?

Yes. Every comment carries its parent's id and its depth; group by parent_id (null = top level) and you have the tree, in the order Reddit showed it for your chosen sort.

Does it work on any subreddit?

On any public post — pass the post URL or its id. Private and quarantined communities do not answer without login, and this collector never logs in.

Is there a free Reddit comments API?

Every account gets $2 of credit every month with no card, which is about 1,000 delivered comments on this endpoint at $0.002 each. It renews monthly, and a run that delivers nothing is never billed — so a failed or blocked attempt does not eat the allowance.

How much does one run cost?

Multiply the rows you actually receive by $0.002. A run capped at 200 comments — the maximum for this collector — costs $0.4 if every row comes back, and less when the source has fewer. Volume tiers take up to 30% off, and GET /v1/scraper/collectors returns the price your key actually pays.

Run the Reddit comments API now

$2 of free credit every month, no card. Your key returns its own prices from GET /v1/scraper/collectors.

Get my free API key