EveryData platform API

Reddit API

Q: What can I retrieve with the Reddit API?

Set `platform` to `reddit`. The current catalog lists search, subreddit posts, post details, comments, and posts by user. These action names identify different Reddit objects or views; they are not interchangeable search modes.

Q: Which input starts a Reddit `search` request?

Specifies the post search query for `search`. Does not search full comment text. Defaults to `relevance` sorting and a primary time window of the past month. Send it as `keyword` inside `params`.

Q: Which fields can Reddit `search` return?

Its declared schema includes `title`, `text`, `author_username`, and `community`. A declared field can still be absent from an individual source record, and every other action has its own field list.

Reddit offers the 5 declared views used here for Reddit search results, subreddit posts, post details, comments, and posts by a user, and `search`, `subreddit_posts`, `post_detail` must each be read according to its own contract.

Reddit keeps `search` (matching public results) apart from `subreddit_posts` (posts in a selected subreddit); `keyword`, and `subreddit` apply only inside those contracts.

Start for free View the public catalog

Endpoint: POST /api/v1/social
Capabilities: 5
Per 1,000: $0.556

Available capabilities

Compare the Reddit actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.

Action	Required	Optional	Delivery	Limit	Per 1,000	Response fields
`search` Search Search public results on Reddit. Accepts these parameters: `keyword` and `sort`. Returns these fields: `author_username`, `posted_at`, `comment_count`, and `text`.	keyword	sort	Sync delivery	Catalog values: defaultLimit=25, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform
`subreddit_posts` Subreddit posts Retrieve subreddit posts from Reddit. Accepts these parameters: `sort`, `subreddit`, and `date_range`. Returns these fields: `title`, `like_count`, `author_username`, and `posted_at`.	subreddit	date_range, sort	Sync delivery	Catalog values: defaultLimit=10, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform
`post_detail` Post details Retrieve post details from Reddit. Accepts these parameters: `sort`, `url`, and `date_range`. Returns these fields: `posted_at`, `title`, `comment_count`, and `author_username`.	url	date_range, sort	Sync delivery	—	$0.56 per 1,000 requests	id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform
`comments` Comments Retrieve public comments from Reddit. Accepts these parameters: `sort`, `url`, and `date_range`. Returns these fields: `posted_at`, `community`, `text`, and `author_username`.	url	date_range, sort	Sync delivery	Catalog values: defaultLimit=10, maxLimit=100. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · text · author_username · like_count · community · url · posted_at · platform
`user_posts` Posts by user Retrieve public posts from Reddit. Accepts these parameters: `username`, `sort`, and `date_range`. Returns these fields: `like_count`, `text`, `community`, and `comment_count`.	username	date_range, sort	Sync delivery	Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count.	$0.56 per 1,000 requests	id · url · title · text · author_username · community · like_count · comment_count · posted_at · platform

What does each Reddit action accept?

Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.

Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.

What do the Reddit `search` parameters mean?

Search public results on Reddit. Accepts these parameters: keyword and sort. Returns these fields: author_username, posted_at, comment_count, and text.

keywordRequired: Specifies the post search query for search. Does not search full comment text. Defaults to relevance sorting and a primary time window of the past month.
sortOptional: Sorts post listings. Allowed values are newest, popular, and relevance; search additionally supports controversial. When present in single-post details or comments endpoints, this parameter does not sort comments.
Allowed values:controversialnewestpopularrelevance
Reddit: Differences Among Relevance, Hot, Top, and NewOfficial Reddit documentation separates Hot (recent interactions) from Top (all-time high votes). On this page, popular corresponds to Hot, not Top; additional sorting and time filters on the official website do not imply that this endpoint supports those same parameters or combinations.Checked 2026-09-04

What do the Reddit `subreddit_posts` parameters mean?

Retrieve subreddit posts from Reddit. Accepts these parameters: sort, subreddit, and date_range. Returns these fields: title, like_count, author_username, and posted_at.

subredditRequired: Specifies the target subreddit for subreddit_posts, such as python or a full subreddit URL. Short names using the r/ prefix are processed via character stripping and may be truncated incorrectly if the name starts with r. For these targets, pass the full /r/subreddit/ URL and verify the result.
Reddit: Community Scopes vs. Site-Wide SearchThe Reddit Help Center distinguishes between searching within a specific community and site-wide search, where subreddit designates the community to which a post belongs. Referencing scope terminology here does not automatically port Boolean operators, Flair, or other filters from the official search box into this endpoint's capabilities.Checked 2026-09-04
date_rangeOptional: Filters posts by time range for subreddit and user listings. Allowed values are all_time, past_hour, past_day, past_week, past_month, and past_year. Whether filtering applies depends on the result set when using fixed post URLs or unsupported sort orders. This cannot be used to filter comments by date.
Allowed values:all_timepast_daypast_hourpast_monthpast_weekpast_year
sortOptional: Sorts post listings. Allowed values are newest, popular, and relevance; search additionally supports controversial. When present in single-post details or comments endpoints, this parameter does not sort comments.
Allowed values:newestpopularrelevance
Reddit: Differences Among Relevance, Hot, Top, and NewOfficial Reddit documentation separates Hot (recent interactions) from Top (all-time high votes). On this page, popular corresponds to Hot, not Top; additional sorting and time filters on the official website do not imply that this endpoint supports those same parameters or combinations.Checked 2026-09-04

What do the Reddit `post_detail` parameters mean?

Retrieve post details from Reddit. Accepts these parameters: sort, url, and date_range. Returns these fields: posted_at, title, comment_count, and author_username.

urlRequired: Specifies the target post URL for post_detail and comments, typically containing /r/subreddit/comments/post_id/. For comments, this retrieves comments and up to five levels of nested replies for that specific post; it is not a global comment search.
Reddit: Post Interaction Counts vs. Author KarmaReddit describes karma as an approximate reflection of votes received on posts and comments, explicitly stating that upvotes and karma do not map one-to-one. This endpoint lacks an author karma field and does not convert like_count or single-post interaction tallies into account karma.Checked 2026-09-04
date_rangeOptional: Filters posts by time range for subreddit and user listings. Allowed values are all_time, past_hour, past_day, past_week, past_month, and past_year. Whether filtering applies depends on the result set when using fixed post URLs or unsupported sort orders. This cannot be used to filter comments by date.
Allowed values:all_timepast_daypast_hourpast_monthpast_weekpast_year
sortOptional: Sorts post listings. Allowed values are newest, popular, and relevance; search additionally supports controversial. When present in single-post details or comments endpoints, this parameter does not sort comments.
Allowed values:newestpopularrelevance

What do the Reddit `comments` parameters mean?

Retrieve public comments from Reddit. Accepts these parameters: sort, url, and date_range. Returns these fields: posted_at, community, text, and author_username.

urlRequired: Specifies the target post URL for post_detail and comments, typically containing /r/subreddit/comments/post_id/. For comments, this retrieves comments and up to five levels of nested replies for that specific post; it is not a global comment search.
Reddit: Single-Post Comment Search vs. Fetching CommentsOfficial Reddit documentation covers in-post comment searching within its website and apps. The comments endpoint on this page fetches comments strictly by post URL; it lacks a comment keyword parameter and does not support full-text comment search simply by referencing official feature descriptions.Checked 2026-09-04
date_rangeOptional: Filters posts by time range for subreddit and user listings. Allowed values are all_time, past_hour, past_day, past_week, past_month, and past_year. Whether filtering applies depends on the result set when using fixed post URLs or unsupported sort orders. This cannot be used to filter comments by date.
Allowed values:all_timepast_daypast_hourpast_monthpast_weekpast_year
sortOptional: Sorts post listings. Allowed values are newest, popular, and relevance; search additionally supports controversial. When present in single-post details or comments endpoints, this parameter does not sort comments.
Allowed values:newestpopularrelevance

What do the Reddit `user_posts` parameters mean?

Retrieve public posts from Reddit. Accepts these parameters: username, sort, and date_range. Returns these fields: like_count, text, community, and comment_count.

usernameRequired: Specifies the username or full /user/username/ URL for user_posts. Short names starting with u may be truncated by current prefix handling; using the full URL and verifying results is recommended.
Reddit: Public Content, Commercial Licensing, and User Rights BoundariesReddit's Public Content Policy strictly distinguishes between browsable content and licensed commercial usage, requiring commercial users to contact the platform and imposing restrictions such as sync deletion and sensitive profiling. Accessing public posts does not grant a platform license; private messages, private communities, and deleted content fall outside its public content licensing scope.Checked 2026-09-04
date_rangeOptional: Filters posts by time range for subreddit and user listings. Allowed values are all_time, past_hour, past_day, past_week, past_month, and past_year. Whether filtering applies depends on the result set when using fixed post URLs or unsupported sort orders. This cannot be used to filter comments by date.
Allowed values:all_timepast_daypast_hourpast_monthpast_weekpast_year
sortOptional: Sorts post listings. Allowed values are newest, popular, and relevance; search additionally supports controversial. When present in single-post details or comments endpoints, this parameter does not sort comments.
Allowed values:newestpopularrelevance

How to use the Reddit API

01Read the public catalog and choose a platform action.
02Send the platform, action, and required parameters to POST /api/v1/social.
03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
04Store the structured response fields needed by your application.

reddit_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"reddit","action":"search","params":{"keyword":"<keyword>"}}'

Reddit API questions

What can I retrieve with the Reddit API?

Set platform to reddit. The current catalog lists search, subreddit posts, post details, comments, and posts by user. These action names identify different Reddit objects or views; they are not interchangeable search modes.

Which input starts a Reddit `search` request?

Specifies the post search query for search. Does not search full comment text. Defaults to relevance sorting and a primary time window of the past month. Send it as keyword inside params.

Which fields can Reddit `search` return?

Its declared schema includes title, text, author_username, and community. A declared field can still be absent from an individual source record, and every other action has its own field list.

Does every Reddit action return immediately?

No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.

Behance API Bilibili API Bluesky API Dailymotion API DeviantArt API Discord API Douban API Douyin API View the public catalog →