The SERPs API allows you to query Google's search engine as if you were making the request through a real browser. Our system will, in real-time, make a request on your behalf, parse the data, and provide you with a structured JSON response.
5 credits / request for successful requestsThe following data points will be collected if they are returned in a parsable format by Google:
Note:
It is not always guaranteed that Google will return all of these data points for each request. The organic results will always be there of course. However, all the remaining data types are only returned if Google deems it fit to return them in its response.
API Endpoint: POST https://api.serpgrid.dev/v1/serps/standard
Required headers: X-API-KEY and Content-Type
| Parameter | Description |
|---|---|
| query | Full text query string - this is the actual Google search boxMax length: 250 characters |
| country | The search's country of originDefault: 'US' --> See list of country codes below |
| language | The search's language preference Default: 'EN' --> See list of language codes below |
| age | Instruct Google to only return data for a certain time periodDefault: ''Accepts: 'last_hour', 'last_day', 'last_week', 'last_month', 'last_year', '' |
| autocorrect | Boolean field that enables/disables Google's autocorrect functionalityDefault: trueAccepts: true, 1 , false, 0 |
| results | The maximum number of organic results (rows) to be returned per pageDefault: 10Accepts: 10, 100 |
| page | The page number you want to get the results forDefault: 1 |
Autocorrect
By default, autocorrect is enabled on all Google searches as this is the way most people interact with Google. When deactivating it, you risk seeing results that differ from the average user. Use with caution!
SERP Standard Request
SERP Standard Response
SERP Standard Request
SERP Standard Response
Below you'll find a list of supported country codes. When passing in one of these values to the country parameter, make sure to use the 2 letter code instead of the country's name.
Country Codes List
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