The Reddit Search API allows you to tap into Google's Reddit index to get up to 100 threads related to your desired search query in a more efficient way than Reddit's own search engine. When making a request through this endpoint, we aggregated your query parameters and pipe them, in real-time, to Google's index allowing you to find Reddit threads in as fast as Google's crawler finds them.
10 credits / request for successful requestsTo keep your query from breaking or returning unexpected results, we sanitize your input as follows:
Leading and trailing empty spaces are removed: ' foo ' --> 'foo'
Multiple consecutive spaces are collapsed into 1: 'foo bar' --> 'foo bar'
API Endpoint: POST https://api.serpgrid.dev/v1/serps/reddit
Required headers: X-API-KEY and Content-Type
| Parameter | Description |
|---|---|
| query | Full text query string The following characters are NOT allowed: " : ( )Max length: 80 characters |
| strict | Boolean field denoting whether you want the search to be an exact character matchDefault: falseAccepts: true, 1 , false, 0 |
| language | Preferred thread language (not guaranteed) Default: 'EN' --> See list of language codes below |
| age | Return only threads from a certain time periodDefault: ''Accepts: 'hour', 'day', 'week', 'month', 'year', '' |
| subreddits[] | An optional array of up to 5 subreddits that you want your search to focus on Subreddits must be provided without the /r/ prefix, ex. microsaasDefault: [] |
Strictness
Strictness indicates whether the search engine should use exact matches or partial - by default strictness is
disabled.If you're researching a competitor's website or a particular brand, it is encouraged to enable strict mode, especially when dealing with domain names.
If you're looking to find threads related to a domain name, such as when researching a competitor, you'll get the best results by using a domain name in your query with the following format:
domain.comPlease notice the lack of scheme (https) and subdomain (www or otherwise). This increases your chances of finding a match.
Additionally, setting strictness to true will yield links to threads where the domain has been explicitly mentioned in the exact format you provide it --> See the example below!
Reddit Search Request
Reddit Search Response
Reddit Search Request
Reddit Search Response
Below you'll find a list of supported language codes. When passing in one of these values to the language parameter, make sure to use the code instead of the language's name.
Language Codes List
The following headers will also be returned as part of the response to you:
X-Credits-Remaining The number of credits that remain in your accountX-Credits-Expire A datetime string with the expiration dateX-Credits-Used The number of credits the operation consumedErrors are handled in line with our Error Rules. Please make sure to read it carefully and follow the instructions for the best experience possible.
SERPGRID