InsightSocial APIReddit API reference: 14 endpoints for subreddits, posts, comment threads, users and search. Per-endpoint credit prices and cURL examples.
Subreddits, posts, comments, user profiles, transcripts and search.
New to the API? Read the Reddit scraper API overview for what it returns and how it compares with the official API.
Base path: /v1/reddit/...
Quickstart
curl "https://api.insightsocial.app/v1/reddit/subreddit?subreddit=technology" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
5 of these are metered: the price depends on how much the call reads. See Credits.
1 are beta: they return the source's own structure under our naming rules (snake_case keys, string ids, ISO times where the source gives a timestamp) rather than a schema-2 entity, and their fields may change. See Schema 2.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/subreddit | 10 | Returns posts from a subreddit, each with title, body, score, comment count, author, permalink, and creation timestamp. | subreddit |
/subreddit/details | 10 | Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL. | subreddit, 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. | query |
/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. | url |
/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. | url |
/subreddit/search | 10–260 | Returns posts matching a query inside one subreddit, each with title, score, comment count, and permalink. | subreddit |
/profile | 10 | Returns one Reddit account: total karma, the post/comment/award karma split, cake day, bio, avatar, banner, trophy count and profile title. | handle |
/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. | handle |
/profile/comments | 20–2000 | 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. | handle |
/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. | query |
/subreddits/search | 10–260 | Returns up to 25 communities matching a topic, each with the name at author.id, subscriber count, description and icon. | query |
/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. | query |
/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. | url |
/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. Beta. | query |