PUpushshift

Search Reddit Posts

Changed on

Search Reddit Submissions

get/reddit/submission/search

Request

  • Base URL
    https://api.pushshift.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.pushshift.io/reddit/submission/search
  • Auth
    HTTP bearer

Query parameters

qstring

Search submissions by title and selftext

idsstring

Search comments by id (comma delimited list for multiple ids

min_scoreinteger

Restrict to submissions with this score or greater

max_scoreinteger

Restrict to submissions with this score or lesser

min_idinteger

Restrict to submissions with this id or greater

max_idinteger

Restrict to submissions with this id or less

min_commentsinteger

Restrict to submissions with this many comments or greater

max_commentsinteger

Restrict to submissions with this many comments or lesser

min_awards_receivedinteger

Restrict results to this number of awards or greater

max_awards_receivedinteger

Restrict results less than or equal to this number of rewards

titlestring

Filter submission titles by keyword or phrase

selftextstring

Filter submission selftext by keyword or phrase

subredditstring

Filter submission by specific subreddits

authorstring

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

exact_authorboolean

Search for exact authors names.

sincestring

Search since an epoch time (inclusive)

untilstring

Search until this epoch time (exclusive)

afterstring

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

beforestring

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)

smartuntilstring

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

order'asc' | 'desc'

An enumeration.

Choose the order of the sorted field

agg_termstring

Perform a terms aggregation on this term

agg_sizeinteger

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

time_histogramstring

Get ggregated data for submissions over time

calendar_histogramstring

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)

limitinteger

Limit number of results returned.

sizeinteger

Alias for limit parameter.

filterstring

Return only specific fields

Response

Successful Response

unknown required

Changes

  • 488c1bcab16dRevision changes
    • info

      added the new optional query request parameter exact_author

  • 9d450866437eRevision changes
    • info

      the endpoint scheme security JWTBearer was added to the API

    • info

      added the new optional query request parameter smartsince

    • info

      added the new optional query request parameter smartuntil