PUpushshift

Search Reddit Comments

Changed on

Search Reddit Comments

get/reddit/comment/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/comment/search
  • Auth
    HTTP bearer

Query parameters

qstring

Search comments by title and selftext

idsstring

Search comments by id (comma delimited list for multiple ids

min_scoreinteger

Restrict to comments with this score or greater

max_scoreinteger

Restrict to comments with this score or lesser

min_idinteger

Restrict to comments with this id or greater

max_idinteger

Restrict to comments with this id or less

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

subredditstring

Filter comments by specific subreddits

authorstring

Search comments 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)

link_idstring

Get all comments for a particular submission

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 aggregated data for comments over time

calendar_histogramstring

Get ggregated data for comments over time using calendar intervals

es_indexstring

Query a specific monthly index directly (usually faster responses)

limitinteger

Limit number of results returned.

sizeinteger

Alias for limit parameter.

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)

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