Google Search
Search for Google results based on keywords.
If you already know that you want to use Google Search, this page is the one you should read. It shows the required input, the filters you can apply, how pagination works, and what localization controls are available.
At a Glance
| Field | Value |
|---|---|
| Name | Google Search |
| Scraper | google_search |
| Engine | google_search |
| Website | |
| Website URL | Google.com |
| Output Format | json |
| Version | 1.0.0 |
| Parameter Count | 19 |
| Parameter Groups | Search Query (1), Localization (5), Advanced Parameters (6), Advanced Filters (3), Geographic Location (2), Pagination (1), Request Controls (1) |
Required Parameters
If you are sending your first request with this engine, start here. Requiredness is based on properties.<field>.must, not the top-level required array.
| Field | Type | Group | Description |
|---|---|---|---|
q | string | Search Query | The keyword or phrase you want this search engine to look up. |
Available Parameters
The sections below follow the same parameter groups as the backend, but the field descriptions have been rewritten into shorter, user-facing wording so they are easier to scan.
Search Query
| Field | Type | Required | Description |
|---|---|---|---|
q | string | Yes | The keyword or phrase you want this search engine to look up. |
Localization
| Field | Type | Required | Description |
|---|---|---|---|
cr | string | No | Limit results to one or more countries. |
gl | string | No | Country or region code used to localize the results. |
hl | string | No | Interface language used for the search and returned SERP labels. |
lr | string | No | Limit results to one or more languages. |
google_domain | string | No | Google domain to query, such as google.com or google.co.uk. |
Additional Constraints
gl：Options: 243 options. Examples:af,al,dz,as,adhl：Options: 157 options. Examples:af,ak,sq,ws,amgoogle_domain：Options: 47 options. Examples:google.com,google.com.hk,google.co.uk,google.co.jp,google.us
Advanced Parameters
| Field | Type | Required | Description |
|---|---|---|---|
si | string | No | Reuse a Google result-state token to open a specific search layout or tab. |
ibp | string | No | Google layout token used to expand or render certain result modules. |
uds | string | No | Google refinement token used to apply a specific suggested filter. |
lsig | string | No | Additional Google place token sometimes needed for local or knowledge panels. |
kgmid | string | No | Google Knowledge Graph entity ID used to target a specific entity. |
ludocid | string | No | Google place or business CID used to target a specific local entity. |
Advanced Filters
| Field | Type | Required | Description |
|---|---|---|---|
tbs | string | No | Advanced Google filter string, often used for time or content filters. |
nfpr | boolean | No | Try to turn off auto-corrected results and keep the original query. |
filter | boolean | No | Turn similar-result or duplicate-result filtering on or off. |
Additional Constraints
nfpr：Default:falsefilter：Default:false
Geographic Location
| Field | Type | Required | Description |
|---|---|---|---|
uule | string | No | Encoded Google location string for more precise geo-targeting. |
location | string | No | Location hint used to make results closer to a target place. |
Additional Constraints
location：Options: 10 options. Examples:IN,US,BR,ID,MX
Pagination
| Field | Type | Required | Description |
|---|---|---|---|
start | number | No | Result offset used for Google-style pagination. |
Additional Constraints
start：Default:0
Request Controls
| Field | Type | Required | Description |
|---|---|---|---|
no_cache | boolean | No | Skip cached results and force a fresh fetch. |
Additional Constraints
no_cache：Default:false