The Reddit Threads API lets you retrieve up to 100 of the most relevant threads for your search query, offering a more efficient alternative to Reddit’s native search engine. When making a request to this endpoint, we aggregate your request parameters and pipe them, in realtime, to Google's index allowing you to find the best matches possible for your query.
5 credits / request for successful requestsResult Relevancy
Data is returned based on its relevancy to your search query and selected age. The more relevant a thread is, the higher it will be in the returned response.
Making multiple requests for the same query in rapid succession (ex submitting the same query multiple times per minute) will only return the same results as newer and more relevant threads are most likely not yet made on Reddit.
To 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: 'foo bar' --> 'foo bar'
The characters " : ( ) are not allowed
API Endpoint: POST https://api.serpgrid.dev/v1/serps/reddit-threads
Required headers: X-API-KEY and Content-Type
| Parameter | Description |
|---|---|
| query | Full text query string The following characters are NOT allowed: " : ( )Min length: 3 charactersMax length: 50 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) --> See list of language codes belowDefault: '' Google's default (en) |
| age | Return only threads from a certain time periodDefault: ''Accepts: 'last_hour', 'last_day', 'last_week', 'last_month', 'last_year', '' |
| subreddit | An optional parameter that allows you to focus your search on a single subreddit Must be provided without the /r/ prefix, ex. microsaasDefault: '' |
| results | The maximum number of rows to be returned if foundDefault: 10Accepts: 10, 100 |
Strictness
Strictness indicates whether the search engine should use exact character matching or keep the default fuzzy search - 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 Threads Request
Reddit Threads Response
Reddit Threads Request
Reddit Threads 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