Reddit API by APISH

Get public Reddit data as clean, consistent JSON: comments of a Reddit post, one Reddit post with top comments, reddit video transcript, search Reddit posts, reddit comment search, reddit user search and more. 12 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

1. Pick an Endpoint. Each option shows what it returns and its price in credits.
2. Enter its Parameters as JSON, for example {"url":"https://www.reddit.com/r/Python/comments/1x89bnq/python_310315_encoding_benchmarks_big_gains_for/"}. All parameters are listed below.
3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

Endpoint	Returns	Required parameters	Credits
/reddit/v1/comments	Comments of a Reddit post	—	1
/reddit/v1/post	One Reddit post with top comments	url	1
/reddit/v1/post/transcript	Reddit video transcript	url	1
/reddit/v1/search	Search Reddit posts	q	1
/reddit/v1/search/comments	Reddit comment search	q	1
/reddit/v1/search/users	Reddit user search	q	1
/reddit/v1/subreddit	Subreddit posts	subreddit	1
/reddit/v1/subreddit/details	Subreddit details and rules	subreddit	1
/reddit/v1/subreddit/search	Search subreddits	q	1
/reddit/v1/user/about	Reddit user profile	username	1
/reddit/v1/user/comments	A Reddit user's comments	username	1
/reddit/v1/user/posts	A Reddit user's posts	username	1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

Comments of a Reddit post

Endpoint /reddit/v1/comments · 1 credit per successful call.

The post's comment tree (25 top-level threads per page). next_cursor loads the next top-level comments; more_replies lists the reply threads Reddit folded, each with its own cursor for this route. next_cursor is null on the last page. Every response includes credits_used: the credits this call cost.

Parameters:

• url: Post URL (instead of subreddit + post_id).
• subreddit
• post_id
• sort: Comment sort: best, top (default), new, controversial, old, qa.
• cursor: next_cursor from the previous page (more top-level comments), or a more_replies[].cursor (the replies Reddit folded under that comment).

One Reddit post with top comments

Endpoint /reddit/v1/post · 1 credit per successful call.

Parameters:

• url (required)

Example parameters: {"url":"https://www.reddit.com/r/Python/comments/1x89bnq/python_310315_encoding_benchmarks_big_gains_for/"}

Reddit video transcript

Endpoint /reddit/v1/post/transcript · 1 credit per successful call.

Speech-to-text on the v.redd.it audio.

Parameters:

• url (required)

Example parameters: {"url":"https://www.reddit.com/r/youseeingthisshit/comments/1kquo45/son_who_lives_abroad_returns_home_and_video_calls/"}

Search Reddit posts

Endpoint /reddit/v1/search · 1 credit per successful call.

Parameters:

• q (required)
• sort: relevance (default), hot, top, new, comments.
• time — one of all, year, month, week, day, hour: Time range: all (default), year, month, week, day, hour.
• subreddit: Search inside one subreddit.
• cursor: Value of next_cursor from the previous page.

Example parameters: {"q":"rust programming"}

Reddit comment search

Endpoint /reddit/v1/search/comments · 1 credit per successful call.

Comments matching a query, with their post and subreddit. Pass next_cursor back as cursor; it is null on the last page. Every response includes credits_used: the credits this call cost.

Parameters:

• q (required)
• sort — one of relevance, top, new: relevance (default), top, new.
• time — one of all, year, month, week, day, hour: all (default), year, month, week, day, hour.
• subreddit: Search inside one subreddit.
• cursor: next_cursor from the previous page.

Example parameters: {"q":"fastapi"}

Reddit user search

Endpoint /reddit/v1/search/users · 1 credit per successful call.

Public Reddit accounts whose name matches the query: username, avatar, karma, description. Pass next_cursor back as cursor. Every response includes credits_used: the credits this call cost.

Parameters:

• q (required)
• cursor: next_cursor from the previous page.

Example parameters: {"q":"python"}

Subreddit posts

Endpoint /reddit/v1/subreddit · 1 credit per successful call.

Pass the same sort and time with the cursor. Pass next_cursor back as cursor for the next posts. next_cursor is null on the last page. Every response includes credits_used: the credits this call cost.

Parameters:

• subreddit (required)
• sort — one of hot, new, top, rising, controversial, best: Feed order: hot (default), new, top, rising, controversial, best.
• time — one of hour, day, week, month, year, all: Time range for top/controversial: hour, day (default), week, month, year, all.
• cursor: Cursor from next_cursor on the previous response; next_cursor is null on the last page.

Example parameters: {"subreddit":"python"}

Subreddit details and rules

Endpoint /reddit/v1/subreddit/details · 1 credit per successful call.

Parameters:

• subreddit (required)

Example parameters: {"subreddit":"programming"}

Search subreddits

Endpoint /reddit/v1/subreddit/search · 1 credit per successful call.

Parameters:

• q (required)
• cursor: Value of next_cursor from the previous page.

Example parameters: {"q":"python"}

Reddit user profile

Endpoint /reddit/v1/user/about · 1 credit per successful call.

A public profile: id, display name, description, karma (post and comment), account creation date, verification, avatar, trophies and the communities the user moderates. Every response includes credits_used: the credits this call cost.

Parameters:

• username (required): Username, u/name or a profile URL.

Example parameters: {"username":"spez"}

A Reddit user's comments

Endpoint /reddit/v1/user/comments · 1 credit per successful call.

Pagination: pass the cursor from next_cursor on the previous response; next_cursor is null on the last page.

Parameters:

• username (required)
• sort — one of new, hot, top, controversial: new (default), hot, top or controversial. Pass the same sort and time with the cursor.
• time — one of hour, day, week, month, year: With top/controversial: hour, day, week, month or year (default year; Reddit serves user feeds no all-time range).
• cursor: Cursor from next_cursor on the previous response; next_cursor is null on the last page.

Example parameters: {"username":"spez"}

A Reddit user's posts

Endpoint /reddit/v1/user/posts · 1 credit per successful call.

Pagination: pass the cursor from next_cursor on the previous response; next_cursor is null on the last page.

Parameters:

• username (required)
• sort — one of new, hot, top, controversial: new (default), hot, top or controversial. Pass the same sort and time with the cursor.
• time — one of hour, day, week, month, year: With top/controversial: hour, day, week, month or year (default year; Reddit serves user feeds no all-time range).
• cursor: Cursor from next_cursor on the previous response; next_cursor is null on the last page.

Example parameters: {"username":"GallowBoob"}

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.