InsightSocial API14 Reddit endpoints on one API key.
Subreddits, posts, comments, user profiles, transcripts and search.
Base path: /v1/reddit/...
Quickstart
curl "https://api.insightsocial.app/v1/reddit/subreddit/details?subreddit=AskReddit" \
-H "x-api-key: $INSIGHTSOCIAL_API_KEY"Endpoints
7 of these are metered: the price depends on how much the call reads. See Credits.
| Endpoint | Credits | What it returns | Key parameters |
|---|---|---|---|
/subreddit | 20–100 | Returns posts from a subreddit, each with title, body, score, comment count, author, permalink, and creation timestamp. | subreddit |
/subreddit/details | 20 | Returns a subreddit's own details: subscriber count, active user count, description, creation date, rules, and icon URL. | subreddit, 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. | query |
/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. | url |
/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. | url |
/subreddit/search | 20–520 | Returns posts matching a query inside one subreddit, each with title, score, comment count, and permalink. | subreddit |
/profile | 20 | 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 | 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. | handle |
/profile/comments | 40–4000 | 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 | 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. | query |
/subreddits/search | 20–520 | Returns up to 25 communities matching a topic, each with the name at author.id, subscriber count, description and icon. | query |
/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. | query |
/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. | url |
/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. | query |