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

# Search Reddit Comments

`GET /reddit/comment/search`

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

---

[API](https://skmtc.dev/pushshift/apis/fastapi.md) · [All operations](https://skmtc.dev/pushshift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pushshift/fastapi/revisions/e73f6bf3c833/schema)
