Search Reddit Posts

Search Reddit Submissions

get/reddit/submission/search

Query parameters

qstring

Search submissions by title and selftext

Search submissions by title and selftext

idsstring

Search comments by id (comma delimited list for multiple ids

Search comments by id (comma delimited list for multiple ids

min_scoreinteger

Restrict to submissions with this score or greater

Restrict to submissions with this score or greater

max_scoreinteger

Restrict to submissions with this score or lesser

Restrict to submissions with this score or lesser

min_idinteger

Restrict to submissions with this id or greater

Restrict to submissions with this id or greater

max_idinteger

Restrict to submissions with this id or less

Restrict to submissions with this id or less

min_commentsinteger

Restrict to submissions with this many comments or greater

Restrict to submissions with this many comments or greater

max_commentsinteger

Restrict to submissions with this many comments or lesser

Restrict to submissions with this many comments or lesser

min_awards_receivedinteger

Restrict results to this number of awards or greater

Restrict results to this number of awards or greater

max_awards_receivedinteger

Restrict results less than or equal to this number of rewards

Restrict results less than or equal to this number of rewards

titlestring

Filter submission titles by keyword or phrase

Filter submission titles by keyword or phrase

selftextstring

Filter submission selftext by keyword or phrase

Filter submission selftext by keyword or phrase

subredditstring

Filter submission by specific subreddits

Filter submission by specific subreddits

authorstring

Search submissions posted by specific authors (comma delimited list accepted)

Search submissions posted by specific authors (comma delimited list accepted)

exact_authorboolean

Search for exact authors names.

Search for exact authors names.

sincestring

Search since an epoch time (inclusive)

Search since an epoch time (inclusive)

untilstring

Search until this epoch time (exclusive)

Search until this epoch time (exclusive)

afterstring

Search after this epoch time (inclusive) -- deprecated (use since)

Search after this epoch time (inclusive) -- deprecated (use since)

beforestring

Search before this epoch time (exclusive) -- deprecated (use until)

Search before this epoch time (exclusive) -- deprecated (use until)

smartsincestring

Search from a specific time using special flags (s=seconds, m=minutes, h=hours, d=days)

Search from a specific time using special flags (s=seconds, m=minutes, h=hours, d=days)

smartuntilstring

Search up to a specific time using special flags (s=seconds, m=minutes, h=hours, d=days)

Search up to a specific time using special flags (s=seconds, m=minutes, h=hours, d=days)

sort'id' | 'created_utc' | 'score'

Choose a specific field to sort returned submissions

Choose a specific field to sort returned submissions

order'asc' | 'desc'

An enumeration.

Choose the order of the sorted field

agg_termstring

Perform a terms aggregation on this term

Perform a terms aggregation on this term

agg_sizeinteger

The number of results to return when performing a terms aggregation

The number of results to return when performing a terms aggregation

shard_sizenumber

The amount of precision to use for terms aggregations. This affects Elasticsearch's doc_count_error_upper_bound

The amount of precision to use for terms aggregations. This affects Elasticsearch's doc_count_error_upper_bound

time_histogramstring

Get ggregated data for submissions over time

Get ggregated data for submissions over time

calendar_histogramstring

Get ggregated data for submissions over time using calendar intervals

Get ggregated data for submissions over time using calendar intervals

track_total_hitsboolean

Get the exact document count for the query (this is slightly more expensive than an estimated count and therefore the default is set to false)

Get the exact document count for the query (this is slightly more expensive than an estimated count and therefore the default is set to false)

limitinteger

Limit number of results returned.

Limit number of results returned.

sizeinteger

Alias for limit parameter.

Alias for limit parameter.

filterstring

Return only specific fields

Return only specific fields

Response

Successful Response

{"stackTrail":"paths:/reddit/submission/search:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 1 revision of this API.