---
title: "Search Reddit Comments"
method: GET
path: "/reddit/comment/search"
---

# 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

Search Reddit Comments

## Query parameters

- `q` string: Search comments by title and selftext
- `ids` string: Search comments by id (comma delimited list for multiple ids
- `min_score` integer: Restrict to comments with this score or greater
- `max_score` integer: Restrict to comments with this score or lesser
- `min_id` integer: Restrict to comments with this id or greater
- `max_id` integer: Restrict to comments with this id or less
- `min_awards_received` integer: Restrict results to this number of awards or greater
- `max_awards_received` integer: Restrict results less than or equal to this number of rewards
- `subreddit` string: Filter comments by specific subreddits
- `author` string: Search comments posted by specific authors (comma delimited list accepted)
- `exact_author` boolean: Search for exact authors names.
- `since` string: Search since an epoch time (inclusive)
- `until` string: Search until this epoch time (exclusive)
- `after` string: Search after this epoch time (inclusive) -- deprecated (use since)
- `before` string: Search before this epoch time (exclusive) -- deprecated (use until)
- `link_id` string: Get all comments for a particular submission
- `smartsince` string: Search from a specific time using special flags (s=seconds, m=minutes, h=hours, d=days)
- `smartuntil` string: 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.
- `agg_term` string: Perform a terms aggregation on this term
- `agg_size` integer: The number of results to return when performing a terms aggregation
- `shard_size` number: The amount of precision to use for terms aggregations. This affects Elasticsearch's doc_count_error_upper_bound
- `time_histogram` string: Get aggregated data for comments over time
- `calendar_histogram` string: Get ggregated data for comments over time using calendar intervals
- `es_index` string: Query a specific monthly index directly (usually faster responses)
- `limit` integer: Limit number of results returned.
- `size` integer: Alias for limit parameter.
- `track_total_hits` boolean: 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)
- `filter` string: Return only specific fields

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2023-09-04** `488c1bcab16d`: 1 info
  - added the new optional `query` request parameter `exact_author`
- **2023-06-21** `9d450866437e`: 3 info
  - the endpoint scheme security `JWTBearer` was added to the API
  - added the new optional `query` request parameter `smartsince`
  - added the new optional `query` request parameter `smartuntil`

[Operation history](https://skmtc.dev/pushshift/apis/pushshift-api/changes/reddit/comment/search/get.md)

---

[API](https://skmtc.dev/pushshift/apis/pushshift-api.md) - [All operations](https://skmtc.dev/pushshift/apis/pushshift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pushshift/apis/pushshift-api/revisions/e73f6bf3c833?raw)