← API Store
Search & SEOGoogle
Google related searches and questions
GET /google/v1/keywordsEvery response includes credits_used: the credits this call cost.
Each call costs 2 credits; failed calls are free. Run it in the console playground to see a live result.
Parameters
| Name | Type | Description |
|---|---|---|
qrequired | string | Search query (also accepted as query or keyword). Example: coffee machine |
country | string | Results for this country (Google gl, and the location defaults to it). Two-letter code. Example: us |
location | string | Search as if from this place, e.g. `Austin,Texas,United States` (Google uule). Default: the country. |
language | string | Interface language (Google hl), e.g. en, de, pt-BR. Example: en |
lr | string | Only results in these languages, e.g. `en` or `en|de`. |
cr | string | Only results from these countries, e.g. `US` or `US|GB`. |
time | string | Only results from the past hour, day, week, month or year; `day_3` = past 3 days. |
date_from | string | Only results from this date (YYYY-MM-DD). |
date_to | string | Only results up to this date (YYYY-MM-DD). |
sort | string | `date` sorts newest first (news). |
tbs | string | Raw Google tbs filter, combined with the options above. |
google_domain | string | Google domain, e.g. google.co.uk. |
safe | string | SafeSearch: on or off. |
autocorrect | string | 0 searches the query exactly as typed (no spelling correction). |
filter | string | 0 also shows near-duplicate results. |
site | string | Only these sites, comma-separated (site:). |
exclude_sites | string | Leave these sites out, comma-separated (-site:). |
filetype | string | Only this file type, e.g. pdf. |
device | string | desktop (default) or mobile results. |
Every endpoint also takes: raw、fields、fresh、output、records
{
"cached": false,
"credits_used": 2,
"people_also_ask": [
"coffee machine",
"What is the best coffee machine for home use?",
"… 3 more"
],
"people_also_ask_detail": [
{
"answer": null,
"href": null,
"question": "coffee machine"
},
{
"answer": null,
"href": null,
"question": "What is the best coffee machine for home use?"
},
"… 3 more"
],
"query": "coffee machine",
"related_searches": [
"Coffee Machine Nespresso",
"Coffee machine commercial",
"… 16 more"
],
"search_parameters": {
"autocorrect": true,
"country": "us",
"cr": null,
"device": "desktop",
"filter": true,
"google_domain": "google.com",
"language": "en",
"limit": 10,
"location": "United States",
"lr": null,
"q": "coffee machine",
"safe": null,
"start": 0,
"tbs": null,
"type": "web"
},
"serp_error": null,
"spelling": null,
"suggestions": [
"coffee machine",
"coffee machine with grinder",
"… 8 more"
],
"total": null
} Response fields (34)
Field paths and types observed in the sample response; the live response is authoritative.
$ | object |
$.cached | boolean |
$.credits_used | integer |
$.people_also_ask | array |
$.people_also_ask[] | string |
$.people_also_ask_detail | array |
$.people_also_ask_detail[] | object | string |
$.people_also_ask_detail[].answer | null |
$.people_also_ask_detail[].href | null |
$.people_also_ask_detail[].question | string |
$.query | string |
$.related_searches | array |
$.related_searches[] | string |
$.search_parameters | object |
$.search_parameters.autocorrect | boolean |
$.search_parameters.country | string |
$.search_parameters.cr | null |
$.search_parameters.device | string |
$.search_parameters.filter | boolean |
$.search_parameters.google_domain | string |
$.search_parameters.language | string |
$.search_parameters.limit | integer |
$.search_parameters.location | string |
$.search_parameters.lr | null |
$.search_parameters.q | string |
$.search_parameters.safe | null |
$.search_parameters.start | integer |
$.search_parameters.tbs | null |
$.search_parameters.type | string |
$.serp_error | null |
$.spelling | null |
$.suggestions | array |
$.suggestions[] | string |
$.total | null |