Reddit scraper API
Reddit posts, comment threads, subreddits, user profiles and search as JSON. No OAuth app and no commercial data agreement.
14 endpoints · from 20 credits a call · 10 free calls · no credit card
curl "https://api.insightsocial.app/v1/reddit/profile?handle=spez" \-H "x-api-key: $INSIGHTSOCIAL_API_KEY"
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.
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. 7 are metered: they show a range and charge what the call actually read.
| Endpoint | Credits | What it returns |
|---|---|---|
| /subreddit | 20–100 | Returns posts from a subreddit, each with title, body, score, comment count, author, permalink, and creation timestamp. |
| /subreddit/details | 20 | Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL. |
| /search | 20–680 | Returns posts matching a keyword from across Reddit, each with title, score, comment count, subreddit, permalink, and the body at ext.selftext. |
| /post | 20 | 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 | 100–180 | 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 | 20–520 | Returns posts matching a query inside one subreddit, each with title, score, comment count, and permalink. |
| /profile | 20 | Returns one Reddit account: total karma, the post/comment/award karma split, cake day, bio, avatar, banner, trophy count and profile title. |
| /profile/posts | 20 | 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 | 40–4,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 | 20 | 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 | 20–520 | Returns up to 25 communities matching a topic, each with the name at author.id, subscriber count, description and icon. |
| /search/media | 20 | 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 | 200 | 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 | 100–180 | 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 | |
|---|---|---|
| Commercial use | Included | A separate agreement with Reddit since 2023 |
| Setup | Sign in and copy a key | OAuth app and token refresh |
| Cost | A published price per endpoint, failures free | Negotiated for commercial use |
| Comment search | Across Reddit by keyword | Not offered |
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 20 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.
Failed calls are free
A call that errors or finds nothing costs 0 credits.
Repeats are free
Call the same thing again inside its window, 1 to 24 hours depending on the endpoint, and it costs 0.
One balance
API calls and Chrome extension exports share the same credits. The free plan includes 500 a month.
Not writing code?
The free Reddit scraper for Chrome exports the same data to Excel, CSV or Google Sheets from your browser, on the same account.
Reddit API: frequently asked questions
You can for personal, non-commercial projects. Since 2023 Reddit requires a separate agreement for commercial use. The InsightSocial API has one published price per endpoint and no agreement to negotiate.
/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.
Yes. /v1/reddit/search/comments searches comments across Reddit, and /v1/reddit/search searches posts. Both are useful for brand monitoring and product research.
A user profile or subreddit lookup is 20 credits. Post lists, comments and search are metered and charge what the call read. Calls that fail or find nothing are free.
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 8 platforms.
Yes. Your first 10 calls priced at 200 credits or less are free, and the free plan includes 500 credits every month. No credit card is needed to get a key.