Reddit API
Fetch public Reddit data — home/popular/games/news feeds, posts, subreddits, search, and user data.
24 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
Feed
4 endpoints- Get gaming feed (v2)GETReturns Reddit's games feed. Optional sort and time control ordering; use after for pagination.
/v2/reddit/games-feed2 cr - Get home feed (v2)GETReturns the default Reddit home feed. Optional sort and filter_posts control results; use after for pagination.
/v2/reddit/home-feed2 cr - Get news feed (v2)GETReturns Reddit's news feed. Optionally filter by subtopic_ids and use after for pagination.
/v2/reddit/news-feed2 cr - List popular posts (v1)GETList posts from r/popular in the same shape as subreddit post results.
/v1/reddit/popular-posts1 cr
Post
5 endpoints- Get a large post batch (v2)GETReturns a large batch of posts identified by required comma-separated post_ids_or_urls. Optional comment fields select a specific included comment.
/v2/reddit/posts/batch-large38 cr - Get post (v1)GETGet a post in the same shape as a feed row, with Reddit's comment total. Takes the post's permalink, or its id with subreddit.
/v1/reddit/post-details1 cr - Get posts in a batch (v2)GETReturns posts identified by required comma-separated post_ids_or_urls. Optional comment fields select a specific included comment.
/v2/reddit/posts/batch8 cr - List comment replies (v2)GETReturns replies under a comment thread. Requires post_id_or_url and the reply cursor; sort_type is optional.
/v2/reddit/post/comments/replies2 cr - List post comments (v1)GETList one batch of a post's comment tree, flattened with depth and parent_fullname. Requires post_id_or_url (and subreddit for a bare id); pass an entry of next_cursors as cursor to load a collapsed branch.
/v1/reddit/post-comments1 cr
Search
3 endpoints- List trending searches (v2)GETReturns Reddit's currently trending search queries. No query fields are required.
/v2/reddit/search/trending2 cr - Search Reddit (v1)GETSearch Reddit posts, communities, comments, people, or media and return results in ranked order.
/v1/reddit/search1 cr - Search suggestions (v2)GETReturns autocomplete suggestions for required keyword. Optional safety fields control mature-content results.
/v2/reddit/search/typeahead2 cr
Subreddit
7 endpoints- Check subreddit muted state (v2)GETReturns the muted-state value for the subreddit identified by required subreddit_id.
/v2/reddit/subreddit/muted2 cr - Get subreddit (v1)GETGet a community's description, creation date, activity figures, and rules. data: null means the community does not exist.
/v1/reddit/subreddit-info1 cr - Get subreddit settings (v2)GETReturns settings for the subreddit identified by required subreddit_id.
/v2/reddit/subreddit/settings2 cr - Get subreddit style (v2)GETReturns visual style and theme data for required subreddit_name.
/v2/reddit/subreddit/style2 cr - List subreddit highlights (v2)GETReturns highlighted content for the subreddit identified by required subreddit_id.
/v2/reddit/subreddit/highlights2 cr - List subreddit post channels (v2)GETReturns post channels and topics for required subreddit_name. Optional sort and range control results.
/v2/reddit/subreddit/post-channels2 cr - List subreddit posts (v1)GETList a subreddit's posts with title, score, upvote ratio, comment count, awards, media, flair and author identity per post — plus a cursor for the next page. Requires subreddit.
/v1/reddit/subreddit-posts1 cr
User
5 endpoints- Get user profile (v1)GETGet an account's ID, names, description, avatar, creation date, and karma breakdown.
/v1/reddit/user-profile1 cr - List user activity (v1)GETList an account's posts and comments in one activity feed. Each row identifies its type in kind.
/v1/reddit/user-posts1 cr - List user comments (v1)GETList an account's comments with body, score, timestamp, permalink, and subreddit.
/v1/reddit/user-comments1 cr - List user trophies (v2)GETReturns trophies earned by required username.
/v2/reddit/user/trophies2 cr - List user's active subreddits (v2)GETReturns subreddits where required username is most active.
/v2/reddit/user/active-subreddits2 cr
What you can build
- Find discussions about a product or topic.
- Collect posts and comments for community research.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v1/reddit/search?q=<q>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.