Can I get every comment on a Reddit post?

/v1/reddit/post/comments returns the comment tree page by page. Reddit collapses very large threads, so the deepest branches of a huge post can be cut short.

Can I search Reddit comments by keyword?

Yes. /v1/reddit/search/comments searches comments across Reddit, and /v1/reddit/search searches posts. Both are useful for brand monitoring and product research.

How much does a Reddit call cost?

A user profile, a subreddit lookup, a page of a subreddit's posts and a page of a user's posts are 10 credits each. A post's comment thread is 50 credits. Search and a user's comment history are metered and charge what the call read. Calls that fail or find nothing are free.

Do I need a Reddit developer account?

No. There is no Reddit app, OAuth flow or review. One API key in the x-api-key header works for Reddit and the other 24 platforms.

Is there a free tier?

Yes. Your first 10 calls priced at 100 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.

What are the Reddit API rate limits?

60 requests a minute and 10 requests in flight at once, per API key. Going over either returns a 429 with a Retry-After header, and a rejected request costs nothing. There is no daily quota: past those two limits, your credit balance is what bounds volume.

How does pagination work on Reddit list endpoints?

List endpoints return rows in data.items and a pagination object with next_cursor and has_more. Send next_cursor back unchanged as the cursor parameter for the next page, and stop when has_more is false. A handful of endpoints page with their own parameter instead; their reference pages name it.

Am I charged for failed calls?

No. A call that errors or finds nothing costs 0 credits. A live fetch costs the endpoint's price, or for a metered endpoint what it actually read. An answer served from the shared cache costs 2 credits. Repeating a call is charged like the first time, because it can return newer data.

How fresh is the Reddit data?

A call fetches live unless a recent copy is in the shared cache, and every response says which with the cached field; a cached answer costs 2 credits. Add fresh=1 or send Cache-Control: no-cache to skip the cache; that call is charged at the normal price.

Is it legal to scrape Reddit?

Collecting publicly available data is generally treated differently from accessing private data, but the answer depends on your jurisdiction, Reddit's terms and what you do with personal data afterwards. The API reads public data only. Talk to a lawyer for anything commercial.

Reddit scraper API

The Reddit scraper API for posts, comment threads, subreddits, user profiles and search, as JSON. No OAuth app to register and no tokens to refresh.

Get a free API key Reddit API docs

14 endpoints · from 10 credits a call · 10 free calls up to 100 credits each · no credit card

curl "https://api.insightsocial.app/v1/reddit/profile?handle=example_redditor" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"

200 OKJSON

{
"success": true,
"platform": "reddit",
"endpoint": "/v1/reddit/profile",
"schema_version": "2",
"data": {
"author": {
"id": "abc123",
"username": "example_redditor",
"display_name": "example_redditor",
"avatar_url": "https://cdn.example.com/avatars/example_redditor.png",
"bio": "Mechanical keyboards and home networking.",
"verified": null,
"followers": null,
"followers_approximate": null,
"following": null,
"posts_count": null,
"likes_count": null,
"url": "https://www.reddit.com/user/example_redditor/",
"location": null,
"external_url": null,
"private": false,
"joined_at": "2017-04-11T00:00:00.000Z",
"last_post_at": null,
"ext": {
"post_karma": 4210,
"comment_karma": 18377,
"awardee_karma": 96,
"trophy_count": 6
}
}
},
"unavailable": [],
"credits_used": 0,
"charge_reason": "miss",
"free_call": true
}

What Reddit data can you get?

Public Reddit data only, returned in the same JSON envelope as every other platform.

Subreddits

A subreddit's details and its posts, and subreddit search by topic.

Posts and comment threads

One post in full with its comment tree, and the spoken text of video posts.

Users

A user's profile, karma, posts and comments.

Search

Posts and comments across Reddit by keyword, and search inside one subreddit.

Reddit API endpoints

All 14 Reddit endpoints and their price in credits. 5 are metered: they show a range and charge what the call actually read.

Endpoint	Credits	What it returns
/subreddit	10	Returns posts from a subreddit, each with title, body, score, comment count, author, permalink, and creation timestamp.
/subreddit/details	10	Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL.
/search	10–300	Returns posts matching a keyword from across Reddit, each with title, score, comment count, subreddit, permalink, and the body at ext.selftext.
/post	10	Returns one post from its URL including the body text, plus score, comment count, share count, author, author avatar, thumbnail, and creation timestamp.
/post/comments	50	Returns the full comment tree for a post, each comment with author, body, score, direct-reply count, nesting depth, timestamp, and its nested replies.
/subreddit/search	10–260	Returns posts matching a query inside one subreddit, each with title, score, comment count, and permalink.
/profile	10	Returns one Reddit account: total karma, the post/comment/award karma split, cake day, bio, avatar, banner, trophy count and profile title.
/profile/posts	10	Returns the posts one account has submitted, newest first, with the body at ext.selftext, score, comment count, upvote ratio, flair, media and ext.subreddit.
/profile/comments	20–2,000	Returns an account's own comment history, newest first, each with the text, score, permalink, parent_id, the post it sits under and ext.subreddit.
/search/comments	10	Returns comments matching a phrase from Reddit's comment index, each with its parent post inline: ext.post_title, ext.subreddit, ext.post_score and ext.post_url.
/subreddits/search	10–260	Returns up to 25 communities matching a topic, each with the name at author.id, subscriber count, description and icon.
/search/media	10	Returns up to 25 Reddit posts that carry an image, video or gallery, with the media at content.media_urls plus title, score, comment count and subreddit.
/post/transcript	100	Returns the transcript of a Reddit video post, both the raw caption file and a plain-text version, when Reddit publishes captions for it.
/omni-search	50–90	Returns threads from across Reddit for one keyword with their top comments inline at top_comments, plus a roll-up of which subreddits are talking, their weekly active users and tone.

Parameters, response fields and examples for each endpoint are in the Reddit API reference.

InsightSocial vs the official Reddit API

Reddit's Data API needs an OAuth app, and since 2023 commercial use needs a separate agreement with Reddit.

	InsightSocial API	Official Reddit API
Setup	Sign in and copy a key	OAuth app and token refresh
Cost	A published price per endpoint, failures free	Set by Reddit's Data API terms
Comment search	Across Reddit by keyword	Not offered
Cost per call	10 credits	Set by Reddit's Data API terms

The official API is the right tool for posting, messaging or managing accounts you own. This one is read-only public data.

How much does the Reddit API cost?

Reddit calls start at 10 credits. Every endpoint's price is in the table above and in the free GET /v1/endpoints catalogue, so you know the cost before you call. Pro's 10,000 monthly credits cover about 1,000 profiles at 10 credits each.

Failed calls are free
A call that errors or finds nothing costs 0 credits.
Retries are free
Resend a request with the same Idempotency-Key and the replay costs 0. Repeating a call without one is charged like the first time, because it can return newer data.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.

See plans and credit packs How credits work

Not writing code?

Connect InsightSocial to Claude or ChatGPT and ask for Reddit data in plain English. Same account, same credits.

Use it from Claude or ChatGPT

Reddit API: frequently asked questions

For many projects it is the right choice. It needs an OAuth app and token handling, and Reddit sets its own terms for how its data may be used. The InsightSocial API needs no app and has one published price per endpoint. Either way, check your use against Reddit's terms and the law where you operate.

Reddit scraper API

What Reddit data can you get?

Subreddits

Posts and comment threads

Users

Search

Reddit API endpoints

InsightSocial vs the official Reddit API

How much does the Reddit API cost?

Failed calls are free

Retries are free

One balance

Not writing code?

Reddit API: frequently asked questions

Reddit API guides

The same key works for 24 more platforms