q ,Search Query(Required)
Define the search query used for data scraping (Default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example using the parameter `q`: pizza
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1"
```
json ,Format(Required)
This parameter defines the output format. Options are JSON, Light JSON, and HTML (downloadable). JSON is the default. Note that Light JSON includes only the top organic Google results.
**Example Request:**\
Example using the parameter `q`: pizza,**`json` :1**
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1"
```
render_js ,JS render(Optional)
If the value is true, the system will employ a browser engine to run page scripts and return the complete rendered HTML.
**Example Request:**\
Example using the parameter `q`: pizza,`render_js` **:**true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "render_js=true"
```
no_cache ,Disable Caching(Optional)
By default, search results with identical parameters are cached for 5 minutes. Set no\_cache to true to bypass the cache, or to false (default) to use cached results. Cached searches are free and will not be counted toward your search statistics.
**Example Request:**\
Example using the parameter `q`: pizza,`no_cache` **:**true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "no_cache=true"
```
ai_overview ,Ai_overview(Optional)
Controls whether to fetch the AI Overview content from Google search results.Billing Note: A successful AI overview fetch typically costs 1 response. If a second request is automatically triggered to resolve a page\_token, the total cost is 2 responses.
**Example Request:**\
Example using the parameter `q`: pizza,**`ai_overview` :**true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "ai_overview=true"
```
google_domain,Domain(Optional)
Define the search engine domain name for data crawling (default value: `google.com`).
You can modify this parameter in the system or refer to the [Google domain page](https://domains.squarespace.com/) to obtain the complete list of supported domain names.
**Example Request:**
Example results for `q` : pizza ,`google_domain`: google.co.ao
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"
```
gl ,Country(Optional)
Specify the target country/region for search results (default value: `us`). Use two-letter country codes(e.g., `us`, `ru`, `uk`).
For the complete list of supported country codes, please refer to: [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Set the interface language for search results (default value: `en`). Adopt standard language code formats (e.g., `en`, `es`, `zh-CN`).
For the complete list of supported language codes, please refer to: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
cr ,Set Multiple Countries(Optional)
Restrict results to specific countries, using `|` as a separator(e.g., `countryFR|countryDE`).
It can be used in conjunction with the `gl` parameter to ensure consistency in interface/content language.
`gl` and `cr` can be combined, but the actual effect follows `cr` as the priority.
**Example Request:**
Example results for `q` : pizza,`cr`: countryFR|countryDE
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "cr=countryAI|countryAQ"
```
lr ,Set Multiple Languages(Optional)
Filters results by language using `lang_XX` codes (e.g., `lang_fr|lang_de`). If the `hl` parameter is used simultaneously, this parameter will override `hl`.
The `hl` and `lr` parameters can be used together, but the actual effect is prioritized by the `lr` parameter.
**Example Request:**
Example results for `q` : pizza,`lr`: lang\_en|lang\_fr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "lr=lang_fr|lang_en"
```
location ,Location(Optional)
Simulate initiating a search from an exact location, which must be used in conjunction with the `uule` parameter. If not specified, the geographical location of the proxy server may be adopted.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
uule ,Encoded Location(Optional)
Encode the target geographical `location` using Base64, which must be used in conjunction with the location parameter.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
tbm ,Search type(Optional)
Defines the search result type:
* `tbm=images` – Images
* `tbm=shops` – Shopping
* `tbm=news` – News
* `tbm=videos` – Videos
**Example Request:**
Example results for `q` : pizza,`tbm`:shop
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "tbm=shops"
```
start ,Result offset(Optional)
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).
We recommend starting with 0 and increasing by 10 for the next page. There is no hard limit on the maximum offset number, but we recommend a maximum of 100 which is the same behavior as with the Google Maps web app. More than that, the result might be duplicated or irrelevant.
**Example Request:**
Example results for `q` : pizza,`start`:30
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "start=30"
```
num ,Number of results per page(Optional)
Subject to Google's limits, actual results may be fewer (max. 10 per page).
**Example Request:**
Example results for `q` : pizza,`num`:20
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "num=20"
```
ludocid ,Google Place ID(Optional)
This parameter defines the identifier (CID) of the Google My Business listing you want to crawl. It is also known as the Google Place ID. (e.g., `ludocid=14389889685039125943`).
**Example Request:**
Example results for `q` : pizza,`ludocid`:14389889685039125943
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "ludocid=14389889685039125943"
```
kgmid ,Google Knowledge Graph ID(Optional)
The `kgmid` parameter is used to directly call encrypted data of specific entries in Google Knowledge Graph, overriding regular search parameters and returning structured results.
**Example Request:**
Example results for `q` : pizza,`kgmid`:/m/0d6lp
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "start=06" \
-d "kgmid=/m/0d6lp"
```
ibp ,Google Element Rendering(Optional)
Used to control the layout rendering and expansion effects of specific elements (such as Knowledge Graph extended searches with `ludocid`).
**Code Example:**
Example results for `q` : pizza,`ibp`:new
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "ibp=new"
```
lsig ,Google Element Rendering(Optional)
This parameter forces the display of the Knowledge Graph map view. lsigId can also be obtained through the redirect link used by Google in 'Google My Business.'
**Code Example:**
Example results for `q` : pizza,`lsig`:new
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "lsig=1"
```
si,Google Cached Search Parameters ID(Optional)
Using the si parameter allows fetching encrypted cached data from Google Search. This parameter overrides all other parameters except 'start' and 'num' and is suitable for collecting Knowledge Graph tab content.
**Code Example:**
Example results for `q` : pizza,`si`:cat
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "si=cat"
```
uds ,Google Filter Search(Optional)
Using the `uds`=ADv parameter allows fetching encrypted cached data from Google Search. This parameter overrides all other parameters except 'start' and 'num' and is suitable for collecting Knowledge Graph tab content.
**Code Example:**
Example results for `q` : pizza,`uds`:ADV
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "uds=ADV"
```
tbs ,Advanced Search Parameters(Optional)
Advanced filters:
* Time: `qdr:h` (1 hour), `qdr:y` (1 year)
* Content: `sur:f` (images), `sur:fc` (free-to-use images)
**Code Example:**
Example results for `q` : pizza,`tbs`:sur:f
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "tbs=sur:f"
```
safe ,Adult Content Filtering(Optional)
Filters adult content:
* `safe=active` – Strict filtering (default)
* `safe=off` – No filtering
**Example Request:**
Example results for `q` : pizza,`safe`:active
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "safe=active"
```
nfpr ,Exclude Auto-corrected Results(Optional)
Define whether to disable automatic spelling correction. For example, with `nfpr=1`, searching for "googl" will not be automatically corrected to "google".
**Code Example:**
Example results for `q` : pizza,`nfpr`:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "nfpr=1"
```
filter ,Results Filtering(Optional)
Define duplicate removal results: `1` (enable), `0` (disable).
**Code Example:**
Example results for `q` : pizza,`filter`:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "filter=1"
```
q ,Search Query(Required)
Define the search query used for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1"
```
google_domain,Domain(Optional)
Defines the domain used for scraping. Default: `google.com`.
Modify this or refer to the [Google Domains page](https://domains.squarespace.com/) for a full list of supported domains.
**Example Request:**
Example results for `q` : pizza ,`google_domain`: google.co.ao
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"
```
gl ,Country(Optional)
Specifies the country/region for localized search results (default: `us`). Uses a two-letter country code (e.g., `us`, `ru`, `uk`).
For supported codes, see [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Sets the UI language for search results (default: `en`). Uses a two-letter language code (e.g., `en`, `es`, `zh-CN`).
Full list: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
location ,Location(Optional)
Simulates searches from a precise location. Must be paired with `uule`. If omitted, the proxy’s location may be used.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
uule ,Encoded Location(Optional)
Encodes the target location via Base64. Use with `location`.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
start ,Result offset(Optional)
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., `0` (default) is the first page of results, `10` is the 2nd page of results, `20` is the 3rd page of results, etc.).
**Example Request:**
Example results for `q` : pizza,`start`:30
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "start=30"
```
num ,Results per page(Optional)
Sets the number of results per page (default: `20`).
**Example Request:**
Example results for `q` : pizza,`num`:20
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "num=20"
```
tbs ，Advanced Search Parameters(Optional)
Time/type filtering (supports complex conditions), such as `tbs`=qdr:d qdr:d= contents within 24 hours `tbs`=sur:f, for example, shows only images
**Example Request:**
Example results for `q` : pizza,`tbs`:sur:f
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "tbs=sur:f"
```
shoprs ，Search Filter ID(Optional)
The parameter defines the token that includes metadata about query and search filter(s). Providing `q`parameter alongside the shoprs is not required.
**Example Request:**
Example results for `q` : pizza,`shoprs`:shoprs\_1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "shoprs=shoprs_1"
```
min_price ，Lowest Price (Optional)
The lower limit for the price range query. This parameter will override the corresponding filter embedded in the 'shoprs' parameter.
**Example Request:**
Example results for `q` : pizza,`min_price`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "min_price=10"
```
max_price ，Highest Price (Optional)
The upper limit for the price range query. This parameter overrides the corresponding filter embedded within the `shoprs` parameter.
**Example Request:**
Example results for `q` : pizza,`max_price`:100
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "min_price=10" \
-d "max_price=100"
```
sort_by，Sort by(Optional)
The parameter defines the sorting order of the results.
Available Options:
`1` - Price: Low to High
`2` - Price: High to Low
**Example Request:**
Example results for `q` : pizza,`sort_by`:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "sort_by=1"
```
free_shipping，free shipping(Optional)
Show only items with free shipping.
**Example Request:**
Example results for `q` : pizza,`free_shipping`:true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "free_shipping=true"
```
on_sale，On Sale (Optional)
Show only items currently on sale.
**Example Request:**
Example results for `q` : pizza,`on_sale`:true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "on_sale=true"
```
small_business，Small Businesses (Optional)
Show only products from small businesses.
**Example Request:**
Example results for `q` : pizza,`small_business`:true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "small_business=true"
```
direct_link，Includes direct links (Optional)
This parameter determines whether search results should include a direct link to each product. By default, it is set to `false`; if you require direct links, please set it to `true`.
**Example Request:**
Example results for `q` : pizza,`direct_link`:true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "direct_link=true"
```
q ,Search Query(Required)
Define the search query used for data scraping (Default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example using the parameter `q`: pizza
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1"
```
google_domain,Domain(Optional)
Define the search engine domain name for data crawling (default value: `google.com`).
You can modify this parameter in the system or refer to the [Google domain page](https://domains.squarespace.com/) to obtain the complete list of supported domain names.
**Example Request:**
Example results for `q` : pizza ,`google_domain`: google.co.ao
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"
```
gl ,Country(Optional)
Specify the target country/region for search results (default value: `us`). Use two-letter country codes(e.g., `us`, `ru`, `uk`).
For the complete list of supported country codes, please refer to: [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Set the interface language for search results (default value: `en`). Adopt standard language code formats (e.g., `en`, `es`, `zh-CN`).
For the complete list of supported language codes, please refer to: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
ll ,GPS Coordinates(Optional)
The GPS parameter defines the coordinates of the location you wish the search to originate from. Its value must match the following format:
`@ + latitude + , + longitude + , + scale`
`@40.7455096,-74.0083012,14z`
**Example Request:**
Example results for `q` : pizza,`ll`: @40.7455096,-74.0083012,14z
```
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1" \
-d "ll=@40.7455096,-74.0083012,14z"
```
type ,Type of search(Optional)
The search parameter defines the type of search to be performed. It can be set to:
`search` - returns a list of results when the q parameter is set,
`place` - returns results for a specific location when the data parameter is set
No parameter is required when using `place_id` or `data_cid`.
**Example Request:**
Example results for `q` : pizza,`type`:search
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1" \
-d "type=search"
```
start ,Result offset(Optional)
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., `0` (default) is the first page of results, `10` is the 2nd page of results, `20` is the 3rd page of results, etc.).\
\
Google Local Results only accepts multiples of `20`(e.g. `20` for the second page results, `40` for the third page results, etc.) as the start value.
**Example Request:**
Example results for `q` : pizza,`start`:30
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1" \
-d "start=30"
```
data ,Data(Optional)
Parameters can be used to filter search results. You can visit the Google Maps website, set up the filters you want, and then simply copy the data values from its `URL` to `SerpApi URL`.
**Example Request:**
Example results for `q` : pizza,`data`:20250815
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1" \
-d "data=20250815"
```
place_id ,Place ID(Optional)
A parameter defines a unique reference to a place in Google Maps. Place ID works for most places, including businesses, landmarks, parks, and intersections. You can find `place_id` using our Google Maps API.
**Example Request:**
Example results for `q` : pizza,`place_id`:541541233999
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1" \
-d "data=20250815" \
-d "place_id=541541233999"
```
data_cid ,Google CID(Optional)
A parameter defines the Google CID (customer identifier) of a place. This parameter can be found in Google Maps API local results, as well as in Google Search API and Google Local API local results, and is named `place_id`. You can also use Google's CID converter to get it.
**Code Example:**
Example results for `q` : pizza,`data_cid`:001
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_maps" \
-d "q=pizza" \
-d "json=1" \
-d "data_cid=001"
```
q ,Search Query(Required)
Define the search query used for data scraping (Default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example using the parameter `q`: pizza
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "json=1"
```
google_domain,Domain(Optional)
Define the search engine domain name for data crawling (default value: `google.com`).
You can modify this parameter in the system or refer to the [Google domain page](https://domains.squarespace.com/) to obtain the complete list of supported domain names.
**Example Request:**
Example results for `q` : pizza ,`google_domain`: google.co.ao
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"
```
gl ,Country(Optional)
Specify the target country/region for search results (default value: `us`). Use two-letter country codes(e.g., `us`, `ru`, `uk`).
For the complete list of supported country codes, please refer to: [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Set the interface language for search results (default value: `en`). Adopt standard language code formats (e.g., `en`, `es`, `zh-CN`).
For the complete list of supported language codes, please refer to: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
location ,Location(Optional)
Simulate initiating a search from an exact location, which must be used in conjunction with the `uule` parameter. If not specified, the geographical location of the proxy server may be adopted.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
uule ,Encoded Location(Optional)
Encode the target geographical `location` using Base64, which must be used in conjunction with the location parameter.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
start ,Result offset(Optional)
Parameter defines the result offset. It skips the given number of results. It's used for pagination. On desktop, parameter only accepts multiples of `20` (e.g. `20` for the second page results, `40` for the third page results, etc.). On mobile, parameter only accepts multiples of `10` (e.g. `10` for the second page results, `20` for the third page results, etc.).
**Example Request:**
Example results for `q` : pizza,`start`:30
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "json=1" \
-d "start=30"
```
ludocid ,Google Place ID(Optional)
This parameter defines the identifier (CID) of the Google My Business listing you want to crawl. It is also known as the Google Place ID. (e.g., `ludocid=14389889685039125943`).
**Example Request:**
Example results for `q` : pizza,`ludocid`:14389889685039125943
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "json=1" \
-d "ludocid=14389889685039125943"
```
tbs ,Advanced Search Parameters(Optional)
Advanced filters:
* Time: `qdr:h` (1 hour), `qdr:y` (1 year)
* Content: `sur:f` (images), `sur:fc` (free-to-use images)
**Code Example:**
Example results for `q` : pizza,`tbs`:sur:f
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_local" \
-d "q=pizza" \
-d "json=1" \
-d "tbs=sur:f"
```
q ,Search Query(Required)
Define the search query used for data scraping (Default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example using the parameter `q`: pizza
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1"
```
gl ,Country(Optional)
Specify the target country/region for search results (default value: `us`). Use two-letter country codes(e.g., `us`, `ru`, `uk`).
For the complete list of supported country codes, please refer to: [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Set the interface language for search results (default value: `en`). Adopt standard language code formats (e.g., `en`, `es`, `zh-CN`).
For the complete list of supported language codes, please refer to: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
apps_category ,Apps Category(Optional)
The parameter defines the app store category.
**Example Request:**
Example results for `q` : pizza,**`apps_category`**:ANDROID\_WEAR
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "apps_category=ANDROID_WEAR"
```
next_page_token,Next Page Token(Optional)
Parameter defines the next page token. It is used for retrieving the next page results. It shouldn't be used with the `section_page_token`, `see_more_token`, and `chart` parameters.
**Example Request:**
Example results for `q` : pizza,`next_page_token`:GAME
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "next_page_token=GAME"
```
section_page_token ,Section Page Token(Optional)
Parameter defines the section page token used for retrieving the pagination results from individual sections. This parameter is a safer version of `see_more_token`, and is found in every row you can paginate into. It shouldn't be used with the `next_page_token`, `see_more_token`, and `chart` parameters
**Example Request:**
Example results for `q` : pizza,**`section_page_token`**:serpapi\_pagination.next\_page\_token
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "section_page_token=serpapi_pagination.next_page_token"
```
chart ,Chart(Optional)
The parameter is used to display the top charts. It returns up to 50 results. Each store contains different charts and requires different values to retrieve results. To get the value of a specific chart, you can use our Google Play app store API JSON output: (chart\_options\[index].value for example chart=topselling\_free). It should not be used with `section_page_token`, `see_more_token`, and `next_page_token` parameters.
**Example Request:**
Example results for `q` : pizza,`chart`:top\_free
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "chart=top_free"
```
see_more_token ,See more token(Optional)
This parameter defines the 'see more' token used to retrieve individual partial paginated results. This token is typically found on the next page of results. It should not be used with `section_page_token`, `next_page_token`, and `chart` parameters.
**Example Request:**
Example results for `q` : pizza,**`section_page_token`**:serpapi\_pagination.next\_page\_token
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "see_more_token=similar_apps"
```
store_device ,Device(Optional)
The parameter defines the device to use for sorting results. This parameter cannot be used with the apps\_category or q parameters. Available options:
`phone` - Phone devices (default)
`tablet` - Tablet devices
`tv` - TV devices
`chromebook` - Chromebook devices
`watch` - Watch devices
`car` - Car devices
**Example Request:**
Example results for `q` : pizza,`store_device`:`phone`
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "store_device=phone"
```
age ,Age(Optional)
Parameter defines age subcategory. age works, and should only be used with apps\_category=FAMILY(Kids Apps)
It can be set to:
`AGE_RANGE1` - Ages up to 5
`AGE_RANGE2` - Ages 6-8
`AGE_RANGE3` - Ages 9-12
**Example Request:**
Example results for `q` : pizza,`age`:AGE\_RANGE1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_play" \
-d "q=pizza" \
-d "json=1" \
-d "age=AGE_RANGE1"
```
q ,Search Query(Required)
Define the search query used for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_news" \
-d "q=pizza" \
-d "json=1"
```
gl ,Country(Optional)
Specifies the country/region for localized search results (default: `us`). Uses a two-letter country code (e.g., `us`, `ru`, `uk`).
For supported codes, see [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_news" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Sets the UI language for search results (default: `en`). Uses a two-letter language code (e.g., `en`, `es`, `zh-CN`).
Full list: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
topic_token ,Topic token(Optional)
Parameter defines the Google News topic token. It is used for accessing the news results for a specific topic (e.g., "World", "Business", "Technology").
**Code Example:**
Example results for `q` : pizza，`topic_token`:Technology
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_news" \
-d "q=pizza" \
-d "json=1" \
-d "topic_token=Technology"
```
publication_token ,Publication token(Optional)
Parameter defines the Google News publication token. It is used for accessing the news results from a specific publisher (e.g., "CNN", "BBC", "The Guardian").
**Example Request:**
Example results for `q` : pizza,`publication_token`:BBC
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_news" \
-d "q=pizza" \
-d "json=1" \
-d "publication_token=BBC"
```
section_token ,Section token(Optional)
Parameter defines the Google News section token. It is used for accessing the sub-section of a specific topic. (e.g., "Business -> Economy").
**Code Example:**
Example results for `q` : pizza,`section_token`:Business
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_news" \
-d "q=pizza" \
-d "json=1" \
-d "section_token=Business"
```
story_token ,Story token(Optional)
Parameter defines the Google News story token. It is used for accessing the news results with full coverage of a specific story.
**Code Example:**
Example results for `q` : pizza,`story_token`:story
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_news" \
-d "q=pizza" \
-d "json=1" \
-d "story_token=story"
```
so ,Sort By(Optional)
Parameter defines the sorting method. Results can be sorted by relevance or by date. By default, the results are sorted by relevance.\
List of supported values are:\
\
`0` - Relevance\
`1` - Date
**Code Example:**
Example results for `q` : pizza,`so`:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_news" \
-d "q=pizza" \
-d "json=1" \
-d "so=1"
```
q ,Search Query(Required)
Define the search query used for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1"
```
google_domain,Domain(Optional)
Defines the domain used for scraping. Default: `google.com`.
Modify this or refer to the [Google Domains page](https://domains.squarespace.com/) for a full list of supported domains.
**Example Request:**
Example results for `q` : pizza ,`google_domain`: google.co.ao
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"
```
gl ,Country(Optional)
Specifies the country/region for localized search results (default: `us`). Uses a two-letter country code (e.g., `us`, `ru`, `uk`).
For supported codes, see [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Sets the UI language for search results (default: `en`). Uses a two-letter language code (e.g., `en`, `es`, `zh-CN`).
Full list: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
lr ,Set Multiple Languages(Optional)
Filters results by language using `lang_XX` codes (e.g., `lang_fr|lang_de`). Overrides `hl` if both are used.
`hl` and`lr` can be used together, but the actual effect follows**`lr`** as the priority.
**Example Request:**
Example results for `q` : pizza,`lr`: lang\_en|lang\_fr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "lr=lang_fr|lang_en"
```
location ,Location(Optional)
Simulates searches from a precise location. Must be paired with `uule`. If omitted, the proxy’s location may be used.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
uule ,Encoded Location(Optional)
Encodes the target location via Base64. Use with `location`.
**Example Request:**
Example results for `q` : pizza,`location`:India,`uule`:w+CAIQICIFSW5kaWE
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
```
start ,Result offset(Optional)
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., `0` (default) is the first page of results, `10` is the 2nd page of results, `20` is the 3rd page of results, etc.).\
\
Google Local Results only accepts multiples of `20`(e.g. `20` for the second page results, `40` for the third page results, etc.) as the start value.
**Example Request:**
Example results for `q` : pizza,`start`:30
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "start=30"
```
num ,Results per page(Optional)
Sets the number of results per page (default: `20`).
**Example Request:**
Example results for `q` : pizza,`num`:20
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "num=20"
```
tbs ,Advanced Search Parameters(Optional)
Advanced filters:
* Time: `qdr:h` (1 hour), `qdr:y` (1 year)
* Content: `sur:f` (images), `sur:fc` (free-to-use images)
**Code Example:**
Example results for `q` : pizza,`tbs`:sur:f
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "tbs=sur:f"
```
safe ,Safe(Optional)
Filters adult content:
* `safe=active` – Strict filtering (default)
* `safe=off` – No filtering
**Example Request:**
Example results for `q` : pizza,`safe`:active
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "safe=active"
```
nfpr ,Exclude Auto-corrected Results(Optional)
Disables autocorrect (e.g., `nfpr=1` prevents "googl" → "google").
**Code Example:**
Example results for `q` : pizza,`nfpr`:sur:f
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "nfpr=1"
```
filter ,Results Filtering(Optional)
Deduplicates results: `1` (enable), `0` (disable).
**Code Example:**
Example results for `q` : pizza,`filter`:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_videos" \
-d "q=pizza" \
-d "json=1" \
-d "filter=1"
```
q ,Search Query(Required)
Define the search query used for data scraping (Default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example using the parameter `q`: pizza
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1"
```
hl ,Language(Optional)
Set the interface language for search results (default value: `en`). Adopt standard language code formats (e.g., `en`, `es`, `zh-CN`).
For the complete list of supported language codes, please refer to: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
geo ,Location(Optional)
The parameter defines the location you wish to search from. It defaults to Worldwide (activated when the value of the `geo` parameter is not set or is empty). Go to Google Trends Locations for a complete list of supported Google Trends locations.
**Example Request:**
Example results for `q` : pizza,`geo`:India
```
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "geo=India"
```
region,Region(Optional)
The parameter is used to get more specific results when using the "By Region Comparison Segment" and "By Region by Interest"data\_type charts. Other data\_type charts do not accept the region parameter. The default value depends on the set geography. Available options:
`COUNTRY` - Country
`REGION` - Subregion
`DMA` - Metro
`CITY` - City
**Example Request:**
Example results for `q` : pizza,`region`:COUNTRY
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "region=COUNTRY"
```
data_type ,data_type(Optional)
Parameter defines the type of search you want to do. Available options:
`TIMESERIES` - Interest over time - Accepts both single and multiple queries per search.
`GEO_MAP` - Compared breakdown by region - Accepts only multiple queries per search.
`GEO_MAP`\_0 - Interest by region - Accepts only single query per search.
`RELATED`\_TOPICS - Related topics - Accepts only single query per search.
`RELATED`\_QUERIES - Related queries - Accepts only single query per search.
**Example Request:**
Example results for `q` : pizza,`data_type`:TIMESERIES
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "data_type=TIMESERIES"
```
tz,Time Zone(Optional)
The parameter defines the time zone offset. The default value is `420` (Pacific Daylight Time (PDT): -07:00). The value is in minutes and ranges from `-1439 to 1439`. tz can be calculated using the difference between UTC+0 and the desired time zone. Example: -PDT
**Example Request:**
Example results for `q` : pizza,`tz`:-1439 to 1439
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "tz=-1439 to 1439"
```
cat,Category (Optional)
The parameter defines the search category. The default value is `0` (all categories).
**Example Request:**
Example results for `q` : pizza,`cat`:7
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "cat=7"
```
gprop ,Property(Optional)
Parameter is used for sorting results by property. The default property is set to Web Search (activated when the value of gprop parameter is not set or empty). Other available options:
`images` - Image Search
`news` - News Search
`froogle` - Google Shopping
`youtube` - YouTube Search
**Code Example:**
Example results for `q` : pizza,`gprop`:froogle
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "gprop=froogle"
```
date ,Date(Optional)
Parameter is used to define a date. Available options:
`now 1-H`- Past hour
`now 4-H` - Past 4 hours
`now 1-d` - Past day
`now 7-d` - Past 7 days
`today 1-m` - Past 30 days
`today 3-m` - Past 90 days
`today 12-m` - Past 12 months
`today 5-y` - Past 5 years
`all - 2004` - present
You can also pass custom values:
Dates from 2004 to present: yyyy-mm-dd yyyy-mm-dd (e.g., 2021-10-15 2022-05-25)
**Code Example:**
Example results for `q` : pizza,`date`:now 1-H
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_trends" \
-d "q=pizza" \
-d "json=1" \
-d "date=now 1-H"
```
q ,Search Query(Required)
Define the search query used for data scraping (Default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**\
Example using the parameter `q`: pizza
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_hotels" \
-d "q=pizza" \
-d "json=1"
```
google_domain,Domain(Optional)
Define the search engine domain name for data crawling (default value: `google.com`).
You can modify this parameter in the system or refer to the [Google domain page](https://domains.squarespace.com/) to obtain the complete list of supported domain names.
**Example Request:**
Example results for `q` : pizza ,`google_domain`: google.co.ao
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_hotels" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"
```
gl ,Country(Optional)
Specify the target country/region for search results (default value: `us`). Use two-letter country codes(e.g., `us`, `ru`, `uk`).
For the complete list of supported country codes, please refer to: [Google’s Country List](https://developers.google.com/adwords/api/docs/appendix/geotargeting).
**Example Request:**
Example results for `q` : pizza,`gl`: ru
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_hotels" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
```
hl ,Language(Optional)
Set the interface language for search results (default value: `en`). Adopt standard language code formats (e.g., `en`, `es`, `zh-CN`).
For the complete list of supported language codes, please refer to: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q` : pizza,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_hotels" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
check_in_date,Check-in Date(Optional)
The parameter defines the check-in date. The format is `YYYY-MM-DD`. For example, `2025-08-22`
**Example Request:**
Example results for `q` : pizza,`check_in_date`:2025-08-22
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_hotels" \
-d "q=Bali Resorts" \
-d "json=1" \
-d "check_in_date=2025-08-22"
```
check_out_date ,Check-out Date(Optional)
The parameter defines the check-out date. The format is `YYYY-MM-DD`. For example, `2025-08-23`
**Example Request:**
Example results for `q` : pizza,`check_out_date`:2025-08-23
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_hotels" \
-d "q=Bali Resorts" \
-d "json=1" \
-d "check_in_date=2025-08-22" \
-d "check_out_date=2025-08-23"
```
adults ,Number of Adults(Optional)
The parameter defines the number of adults. The default is`2`.
**Code Example:**
Example results for `q` : pizza,`adults`:2
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_hotels" \
-d "q=Bali Resorts" \
-d "json=1" \
-d "adults=2"
```
departure_id,Departure airport code (Required)
Parameter defines the departure airport code or location kgmid.\
An airport code is an uppercase 3-letter code. You can search for it on [Google Flights](https://www.google.com/travel/flights) or [IATA](https://www.iata.org/en/publications/directories/code-search).\
For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstrom International Airport.\
A location kgmid is a string that starts with `/m/`. You can search for a location on [Wikidata](https://www.wikidata.org/) and use its "Freebase ID" as the location kgmid. For example, `/m/0vzm` is the location kgmid for Austin, TX.\
You can specify multiple departure airports by separating them with a comma. For example, `CDG,ORY,/m/04jpl`.
**Example Request:**\
Example using the parameter **`departure_id`**: CDG
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "outbound_date=2025-08-31"
```
arrival_id,Arrival airport code (Required)
Parameter defines the arrival airport code or location kgmid.\
An airport code is an uppercase 3-letter code. You can search for it on [Google Flights](https://www.google.com/travel/flights) or [IATA](https://www.iata.org/en/publications/directories/code-search).\
For example, `CDG` is Paris Charles de Gaulle Airport and `AUS` is Austin-Bergstrom International Airport.\
A location kgmid is a string that starts with `/m/`. You can search for a location on [Wikidata](https://www.wikidata.org/) and use its "Freebase ID" as the location kgmid. For example, `/m/0vzm` is the location kgmid for Austin, TX.\
You can specify multiple arrival airports by separating them with a comma. For example, `CDG,ORY,/m/04jpl`.
**Example Request:**\
Example using the parameter **`arrival_id`**: AUS
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "outbound_date=2025-08-31"
```
outbound_date ,utbound Date(Optional)
Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. `2025-08-31`
**Example Request:**
Example results for **`departure_id`**: CDG,**`arrival_id`**: AUS,`outbound_date`:2025-08-31
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "outbound_date=2025-08-31"
```
return_date ,Return Date(Optional)
Parameter defines the return date. The format is YYYY-MM-DD. e.g. `2025-09-06`
**Example Request:**
Example results for **`departure_id`**: CDG,**`arrival_id`**: AUS,`return_date`:2025-09-06
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "outbound_date=2025-08-31" \
-d "return_date=2025-09-06"
```
travel_class ,Travel Class(Optional)
Parameter defines the travel class.\
Available options:\
\
`1` - Economy (default)\
`2` - Premium economy\
`3` - Business\
`4` - First
**Code Example:**
Example results for **`departure_id`**: CDG,**`arrival_id`**: AUS,`travel_class`:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "travel_class=1"
```
adults ,Number of Adults(Optional)
This parameter defines the number of adults. The default value is 1.
**Code Example:**
Example results for **`departure_id`**: CDG,**`arrival_id`**: AUS,**`adults`**:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "adults=1"
```
children ,Number of Children(Optional)
This parameter defines the number of children. The default value is 0.
**Example Request:**
Example results for **`departure_id`**: CDG,**`arrival_id`**: AUS,**`children`**:0
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "children=0"
```
infants_in_seat,Number of Infants in seat(Optional)
This parameter defines the number of infants that can be accommodated in a seat. The default value is 0.
**Code Example:**
Example results for **`departure_id`**: CDG,**`arrival_id`**: AUS,**`infants_in_seat`**:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "infants_in_seat=1"
```
infants_on_lap ,Number of Infants on lap(Optional)
This parameter defines the number of lap infants. The default value is 0.
**Code Example:**
Example results for **`departure_id`**: CDG,**`arrival_id`**: AUS,**`infants_on_lap`**:0
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_flights" \
-d "departure_id=CDG" \
-d "arrival_id=AUS" \
-d "json=1" \
-d "infants_on_lap=0"
```
q ,Search Query(Required)
Define the search query used for data scraping (Default value: `q=GOOGL:NASDAQ`). Any keywords in any language are supported.
**Example Request:**\
Example using the parameter `q=GOOGL:NASDAQ`
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_finance" \
-d "q=GOOGL:NASDAQ" \
-d "json=1"
```
hl ,Language(Optional)
Set the interface language for search results (default value: `en`). Adopt standard language code formats (e.g., `en`, `es`, `zh-CN`).
For the complete list of supported language codes, please refer to: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).
**Example Request:**
Example results for `q=GOOGL:NASDAQ`,`hl`: es
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_finance" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
```
window ,Time Range(Optional)
Parameter is used for setting time range for the graph. It can be set to:
`1D` - 1 Day(default)
`5D` - 5 Days
`1M` - 1 Month
`6M` - 6 Months
`YTD` - Year to Date
`1Y` - 1 Year
`5Y` - 5 Years
`MAX` - Maximum
**Example Request:**
Example results for `q=GOOGL:NASDAQ`,`window`:6M
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_finance" \
-d "q=GOOGL:NASDAQ" \
-d "json=1" \
-d "window=6M "
```
q ,Search Query(Required)
Define the search query for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1"
```
cc ,Country(Optional)
This parameter defines that during crawling, you can specify that search results be displayed according to the habits of users in a specific country/region. It is a two-letter country/region code (for example: `us`, `ru`, `uk`).
**Examples:**
* `cc=us` → United States (English)
* `cc=fr` → France (French)
**Example Request:**
Example results for `q` : pizza,`cc`:jp
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "cc=jp"
```
mkt ,Language(Optional)
This parameter defines the interface display language of search results during crawling. It adopts the format of <"language code">-<"country/region code">.
For example, `en-US`. This string is case-insensitive.
**Examples:**
* `mkt=en-US` → English (United States)
* `mkt=zh-CN` → Simplified Chinese
**Example Request:**
Example results for `q` : pizza,`mkt`:fr-fr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "mkt=fr-fr"
```
location ,Location(Optional)
This parameter defines the starting geographical location for crawling and should be used in conjunction with the `lat` (latitude) and `lon` (longitude) parameters.
**Example Request:**
Example results for `q` : pizza,`location`:Tokyo
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "location=Tokyo%2CJapan" \
-d "uule=w+CAIQICILVG9reW8sSmFwYW4"
```
lat ,Latitude(Optional)
GPS latitude (-90.0 to 90.0). **Must be used with `lon`.**
This parameter defines the GPS latitude of the starting geographical location during crawling. It is used together with the `location` (geographical location) and `lon` (longitude) parameters.
**Example Request:**
Example results for `q` : pizza,`lat`:40.7128
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "lat=40.7128" \
-d "lon=-74.0060"
```
lon ,Longitude(Optional)
GPS longitude (-180.0 to 180.0). **Must be used with `lat`.**
This parameter defines the GPS longitude of the starting geographical location during crawling. It is used together with the `location` (geographical location) and `lat` (latitude) parameters.
**Example Request:**
Example: `-74.0060` for New York.
Example results for `q` : pizza,`lon`:-74.0060
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "lat=40.7128" \
-d "lon=-74.0060"
```
first ,Result offset(Optional)
Sets the result offset (default: `1`). For example, `first=10` skips the first 9 results.
This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when `first=10`, the system will promote the 10th organic search result to the top position.
**Example Request:**
Example results for `q` : pizza,`first`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
count ,Results per page(Optional)
Number of results per page (range: `1`–`50`). Use with `first` for pagination.
The per-page parameter is used to control the number of search results displayed per page (minimum value: 1, maximum value: 50). The actual effective value will be affected by the `first` offset parameter.
**Example Request:**
Example results for `q` : pizza,`count`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
adlt ,Safe(Optional)
This parameter defines whether adult content is blocked from search results. You can set it to either "`strict`" or "`off`".
Adult content filter:
* `strict` → Default (blocks adult content)
* `off` → Allows adult content
**Example Request:**
Example results for `q` : pizza,`adlt`:strict
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing" \
-d "q=pizza" \
-d "json=1" \
-d "adlt=strict"
```
q ,Search Query(Required)
Define the search query for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_images" \
-d "q=pizza" \
-d "json=1"
```
cc ,Country(Optional)
This parameter defines that during crawling, you can specify that search results be displayed according to the habits of users in a specific country/region. It is a two-letter country/region code (for example: `us`, `ru`, `uk`).
**Examples:**
* `cc=us` → United States (English)
* `cc=fr` → France (French)
**Example Request:**
Example results for `q` : pizza,`cc`:jp
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_images" \
-d "q=pizza" \
-d "json=1" \
-d "cc=jp"
```
mkt ,Language(Optional)
This parameter defines the interface display language of search results during crawling. It adopts the format of <"language code">-<"country/region code">.
For example, `en-US`. This string is case-insensitive.
**Examples:**
* `mkt=en-US` → English (United States)
* `mkt=zh-CN` → Simplified Chinese
**Example Request:**
Example results for `q` : pizza,`mkt`:fr-fr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_images" \
-d "q=pizza" \
-d "json=1" \
-d "mkt=fr-fr"
```
first ,Result offset(Optional)
Sets the result offset (default: `1`). For example, `first=10` skips the first 9 results.
This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when `first=10`, the system will promote the 10th organic search result to the top position.
**Example Request:**
Example results for `q` : pizza,`first`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_images" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
count ,Results per page(Optional)
Number of results per page (range: `1`–`50`). Use with `first` for pagination.
The per-page parameter is used to control the number of search results displayed per page (minimum value: 1, maximum value: 50). The actual effective value will be affected by the `first` offset parameter.
**Example Request:**
Example results for `q` : pizza,`count`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_images" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
adlt ,Safe(Optional)
This parameter defines whether adult content is blocked from search results. You can set it to either "`strict`" or "`off`".
Adult content filter:
* `strict` → Default (blocks adult content)
* `off` → Allows adult content
**Example Request:**
Example results for `q` : pizza,`adlt`:strict
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_images" \
-d "q=pizza" \
-d "json=1" \
-d "adlt=strict"
```
q ,Search Query(Required)
Define the search query for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_maps" \
-d "q=pizza" \
-d "json=1"
```
setlang ,Language(Optional)
This parameter defines the language to search in. It follows the format gb characters followed by ISO\_3166-1. (For example, United States, Germany, United Kingdom, etc.)
**Example Request:**
Example results for `q` : pizza,setlang:eu
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_maps" \
-d "q=pizza" \
-d "json=1" \
-d "setlang=eu"
```
cp GPS Coordinates(Optional)
This parameter defines the GPS coordinates of the location you wish to apply q (query). It must be constructed in the following sequence:
latitude++This will form a string that looks like this: e.g. \~longitude
40.7455096\~-74.0083012
**Example Request:**
Example results for `q` : pizza,`cp`:40.7455096\~-74.0083012
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_maps" \
-d "q=pizza" \
-d "json=1" \
-d "cp=40.7455096~-74.0083012"
```
first ,Result offset(Optional)
Sets the result offset (default: `1`). For example, `first=10` skips the first 9 results.
This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when `first=10`, the system will promote the 10th organic search result to the top position.
**Example Request:**
Example results for `q` : pizza,`first`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_maps" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
count ,Results per page(Optional)
Number of results per page (range: `1`–`50`). Use with `first` for pagination.
The per-page parameter is used to control the number of search results displayed per page (minimum value: 1, maximum value: 50). The actual effective value will be affected by the `first` offset parameter.
**Example Request:**
Example results for `q` : pizza,`count`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_maps" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
place_id ,Place ID(Optional)
This parameter defines a unique reference to a place on the Bing map. Most places have a location ID, including businesses, landmarks, parks, and intersections. You can use our Bing map API and Bing local pack API to find place\_id.
place\_id can be used without any other optional parameters (including the q parameter).
**Example Request:**
Example results for `q` : pizza,`place_id`:1000956545321
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_maps" \
-d "q=pizza" \
-d "json=1" \
-d "place_id=1000956545321"
```
q ,Search Query(Required)
Parameter defines the search query. You can use anything that you would use in a regular Bing search.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_news" \
-d "q=pizza" \
-d "json=1"
```
cc ,Country(Optional)
This parameter defines that during crawling, you can specify that search results be displayed according to the habits of users in a specific country/region. It is a two-letter country/region code (for example: `us`, `ru`, `uk`).
**Examples:**
* `cc=us` → United States (English)
* `cc=fr` → France (French)
**Example Request:**
Example results for `q` : pizza,`cc`:jp
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_news" \
-d "q=pizza" \
-d "json=1" \
-d "cc=jp"
```
setlang ,Language(Optional)
This parameter defines the language to search in. It follows the format gb characters followed by ISO\_3166-1. (For example, United States, Germany, United Kingdom, etc.)
**Example Request:**
Example results for `q` : pizza,setlang:eu
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_news" \
-d "q=pizza" \
-d "json=1" \
-d "setlang=eu"
```
mkt ,Language(Optional)
This parameter defines the interface display language of search results during crawling. It adopts the format of <"language code">-<"country/region code">.
For example, `en-US`. This string is case-insensitive.
**Examples:**
* `mkt=en-US` → English (United States)
* `mkt=zh-CN` → Simplified Chinese
**Example Request:**
Example results for `q` : pizza,`mkt`:fr-fr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_news" \
-d "q=pizza" \
-d "json=1" \
-d "mkt=fr-fr"
```
first ,Result offset(Optional)
Sets the result offset (default: `1`). For example, `first=10` skips the first 9 results.
This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when `first=10`, the system will promote the 10th organic search result to the top position.
**Example Request:**
Example results for `q` : pizza,`first`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_news" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
count ,Results per page(Optional)
Number of results per page (range: `1`–`50`). Use with `first` for pagination.
The per-page parameter is used to control the number of search results displayed per page (minimum value: 1, maximum value: 50). The actual effective value will be affected by the `first` offset parameter.
**Example Request:**
Example results for `q` : pizza,`count`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_news" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
qft,Sort by Date(Optional)
This parameter defines whether adult content is blocked from search results. You can set it to either "`strict`" or "`off`".
Adult content filter:
* `strict` → Default (blocks adult content)
* `off` → Allows adult content
**Example Request:**
Example results for `q` : pizza,`qft`:interval="8"
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_news" \
-d "q=pizza" \
-d "json=1" \
-d "setlang=eu" \
-d "qft=interval="8""
```
q ,Search Query(Required)
Define the search query for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_shopping" \
-d "q=pizza" \
-d "json=1"
```
cc ,Country(Optional)
This parameter defines that during crawling, you can specify that search results be displayed according to the habits of users in a specific country/region. It is a two-letter country/region code (for example: `us`, `ru`, `uk`).
**Examples:**
* `cc=us` → United States (English)
* `cc=fr` → France (French)
**Example Request:**
Example results for `q` : pizza,`cc`:jp
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "cc=jp"
```
mkt ,Language(Optional)
This parameter defines the interface display language of search results during crawling. It adopts the format of <"language code">-<"country/region code">.
For example, `en-US`. This string is case-insensitive.
**Examples:**
* `mkt=en-US` → English (United States)
* `mkt=zh-CN` → Simplified Chinese
**Example Request:**
Example results for `q` : pizza,`mkt`:fr-fr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "mkt=fr-fr"
```
efirst ,Result offset(Optional)
Sets the result offset (default: `1`). For example, `first=10` skips the first 9 results.
This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when `first=10`, the system will promote the 10th organic search result to the top position.
**Example Request:**
Example results for `q` : pizza,`efirst`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "efirst=10"
```
filters ,Additional Filtering(Optional)
Parameters allow for more complex filtering options, such as filtering by date range ex1:"ez5\_18169\_18230" or using specific display filters
(e.g. ufn:"Wunderman+Thompson"+sid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513"+catguid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513\_cfb02057"+segment:"generic.carousel"+entitysegment:"Organization").
You can use Bing search and copy filters query parameters to construct precise values.
**Example Request:**
Example results for `q` : pizza,`filters`:ex1:"ez5\_18169\_18230"
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "filters=ex1:"ez5_18169_18230""
```
q ,Search Query(Required)
Define the search query for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_videos" \
-d "q=pizza" \
-d "json=1"
```
cc ,Country(Optional)
This parameter defines that during crawling, you can specify that search results be displayed according to the habits of users in a specific country/region. It is a two-letter country/region code (for example: `us`, `ru`, `uk`).
**Examples:**
* `cc=us` → United States (English)
* `cc=fr` → France (French)
**Example Request:**
Example results for `q` : pizza,`cc`:jp
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_videos" \
-d "q=pizza" \
-d "json=1" \
-d "cc=jp"
```
mkt ,Language(Optional)
This parameter defines the interface display language of search results during crawling. It adopts the format of <"language code">-<"country/region code">.
For example, `en-US`. This string is case-insensitive.
**Examples:**
* `mkt=en-US` → English (United States)
* `mkt=zh-CN` → Simplified Chinese
**Example Request:**
Example results for `q` : pizza,`mkt`:fr-fr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_videos" \
-d "q=pizza" \
-d "json=1" \
-d "mkt=fr-fr"
```
first ,Result offset(Optional)
Sets the result offset (default: `1`). For example, `first=10` skips the first 9 results.
This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when `first=10`, the system will promote the 10th organic search result to the top position.
**Example Request:**
Example results for `q` : pizza,`first`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_videos" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
count ,Results per page(Optional)
Number of results per page (range: `1`–`50`). Use with `first` for pagination.
The per-page parameter is used to control the number of search results displayed per page (minimum value: 1, maximum value: 50). The actual effective value will be affected by the `first` offset parameter.
**Example Request:**
Example results for `q` : pizza,`count`:10
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_videos" \
-d "q=pizza" \
-d "json=1" \
-d "first=10" \
-d "count=10"
```
adlt ,Safe(Optional)
This parameter defines whether adult content is blocked from search results. You can set it to either "`strict`" or "`off`".
Adult content filter:
* `strict` → Default (blocks adult content)
* `off` → Allows adult content
**Example Request:**
Example results for `q` : pizza,`adlt`:strict
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=bing_videos" \
-d "q=pizza" \
-d "json=1" \
-d "adlt=strict"
```
q ,Search Query(Required)
Define the search query for data crawling (default value: q=pizza). Any keywords in any language are supported.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1"
```
yandex_domain ,Domain(Optional)
This parameter defines the domain name used for crawling, with a default value:`yandex.com`.\
**Available options:**
* `yandex.com`
* `yandex.ru`
* `yandex.com.tr`\
(Other regional domains supported)
**Example Request:**
Example results for `q` : pizza,`url`:yandex.com.tr
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "yandex_domain=yandex.com" \
-d "json=1"
```
lang ,Language(Optional)
This parameter defines the language used for search results during crawling, with a default value of "`en`". It is a two-letter language code (for example, `en`, `ru`, `es`).\
**Common values:**
* `en` (English)
* `ru` (Russian)
* `es` (Spanish)\
Full list: [Yandex Language Codes](https://yandex.com/support/search/query-language.html)
**Example Request:**
Example results for `q` : pizza,`lang`:en
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "lang=en"
```
lr ,Location(Optional)
Specify the region for search results (e.g., `lr=Moscow,Russia` displays only results from Moscow), which takes priority over IP-based geolocation.
\
Format: `lr=rstr ,Location Strict Check(Optional)
Dual filtering:
* Region lock: Forces results to match `lr` region
* Safe search: `rstr=family` blocks adult content
**Example Request:**
Example results for `q` : pizza,`rstr`:true
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "rstr=true"
```
p ,Page number(Optional)
Page control (starts at `p=0`).
It needs to be used in conjunction with the parameter for the number of items per page.
Example: `p`=2 retrieves results from the 3rd page.
**Example Request:**
Example results for `q` : pizza,`p`:2
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "p=2"
```
within ,Time period(Optional)
Time/domain restrictions:
* Time range: `within=7d` (Past 7 days)
* Domain filter: `within=example.com`
**Example Request:**
Example results for `q` : pizza,`within`:2
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=yandex" \
-d "text=pizza" \
-d "json=1" \
-d "within=2"
```
q ,Search Query(Required)
Define the search query used for data crawling (default value: `q=pizza`). Any keywords in any language are supported.
**Example Request:**
Example with `q`:pizza parameter
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=duckduckgo" \
-d "q=pizza" \
-d "json=1"
```
kl ,Location(Optional)
Specify the interface language and region for search results (e.g., "`zh-cn`"
provides a Simplified Chinese interface and prioritizes displaying results from the China region).
**Example Request:**
Example results for `q` : pizza,`kl`:japan
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=duckduckgo" \
-d "q=pizza" \
-d "json=1" \
-d "kl=Japan"
```
start ,Result offset(Optional)
Set the starting point for search result pagination (e.g., "`start=30`" means skipping the first 30 results and starting to display from the 31st result).\
**Rules:**
* `start=30` → Skips first 30 results (page 2)
* Max: `start=500` (result quality declines after \~16 pages)
**Example Request:**
Example results for `q` : pizza,`start`:2
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=duckduckgo" \
-d "q=pizza" \
-d "json=1" \
-d "start=2"
```
df ,Filter By Date(Optional)
Filter search results by time range ('`d` = past 24 hours', '`w` = past week', '`m` = past month').
Filters results by time range:
| Value | Time Range | Use Case |
|---|---|---|
d | Last 24 hours | Time-sensitive queries |
w | Last 1 week | Balanced freshness/coverage |
m | Last 1 month | Default range |
y | Last 1 year | Historical data |
kp ,Safe(Optional)
Set the search content safety filtering level (Strict / Moderate / Disabled) to filter sensitive information such as adult content, violence, etc.
Safe search filtering:
* `kp=-2`: Strict (default)
* `kp=-1`: Moderate
* `kp=1`: Disabled (may trigger CAPTCHA)
**Example Request:**
Example results for `q` : pizza,`kp`:1
```sh
curl -X POST https://serpapi.talordata.net/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=duckduckgo" \
-d "q=pizza" \
-d "json=1" \
-d "kp=1"
```
| Talordata Account | Register an account to get 1,000 free SERP API requests. | |
| Talordata API Token | Get your API key from the SERP API dashboard. |
Google (25)
Search, Finance, Finance Markets, Flights, Hotels, Images, Jobs, Lens, Local, Maps, News, Patents, Patents Details, Play Search, Play Books, Play Games, Play Movies, Play Product, Scholar, Scholar Author, Scholar Cite, Shopping, Trends, Videos, WebBing (6)
Search, Images, Maps, News, Shopping, VideosYandex (1)
SearchDuckDuckGo (1)
SearchThis guide explains how to integrate TalorData Web MCP with n8n to build automated, AI-driven workflows. You can connect the MCP to n8n via: \ **Streamable HTTP MCP – the easiest cloud-based setup.** ### Streamable HTTP MCP Integration For most users, Streamable HTTP is recommended. It enables n8n AI agents to interact with TalorData MCP via real-time streaming over HTTPS without requiring local setup. #### Require * Register for a [TalorData account](https://www.talordata.com/) * Go to [SERP API-API Token](https://dashboard.talordata.com/scraping/serp-api/api-token/) to creat an API Token * AI-powered workflows in n8n (e.g., AI agents) ### How to configure a remote MCP {% stepper %} {% step %} #### Create an AI agent in n8n or your preferred AI orchestration platform. {% endstep %} {% step %} #### Install the following components: * Chat models (e.g., GPT-4, GPT-4o) * MCP client node {% endstep %} {% step %} #### Configure the remote MCP URL using your API token: ``` https://mcp.talordata.net/YOUR_API_TOKEN_HERE/mcp ``` {% endstep %} {% step %} #### Select MCP Tool * Clearly and publicly disclose specific tools. * Enable AI agents to dynamically select tools. Once configured, the AI agent will invoke MCP tools as needed and stream responses back to your workflow in real time. {% endstep %} {% endstepper %} #### When to Use Streamable HTTP * No-code or low-code automation * Rapid deployment with minimal infrastructure requirements * Cloud-hosted n8n deployment * Real-time, AI-powered data extraction # Cursor MCP Server Integration Integrate Talordata MCP Server with Cursor to give AI agents access to real-time SERP data and structured search results. Connect Cursor IDE to the TalorData MCP server (featuring over 30 engines) to enable web search and scraping capabilities for the AI coding assistant. ### Hosted MCP Before you begin, please ensure you have the following items ready: * [Node.js](https://nodejs.org/en/download) Installed and the latest version * [TalorData account](https://www.talordata.com/) (New users receive a free trial credit; subsequent usage is pay-as-you-go.) * [SERP API-API Token](https://dashboard.talordata.com/scraping/serp-api/api-token/) page's API Token #### Basic Configuration Go to "Cursor" -> click the gear icon -> "Tools and Integrations" -> "Add Custom MCP" -> add the following: ``` { "mcpServers": { "talor-serp": { "url": "https://mcp.talordata.net/API_TOKEN/mcp" } } } ```
**With the TalorData n8n integration, you can:** * Execute SERP searches on Google, Bing, DuckDuckGo, Yandex, and more directly within n8n. * Utilize localized search parameters such as country/region, language, device, and market. * Integrate search results into workflows involving AI agents, reporting pipelines, alerts, data enrichment, and more. * Pass advanced SERP parameters via raw request mode for scenarios requiring greater control. ### Preparations Before you begin, please ensure you have: * A working n8n instance. * Permissions for installing n8n community nodes. * A [**TalorData SERP API key**](https://dashboard.talordata.com/scraping/serp-api/api-token) starting with **`sk_`**. ### Specific steps {% stepper %} {% step %} #### **Installation** Install the TalorData node from the n8n Community Nodes panel: * Open your n8n instance. * Go to `Settings` > `Community Nodes`。 * Click `Install`。 * Enter package name: ``` n8n-nodes-talordata-serp ``` * Confirm installation. * If your deployment environment requires a restart, please restart n8n. **After installation, n8n will add:** * A credential type named Talordata SERP API. * A workflow node named Talordata SERP. {% endstep %} {% step %} #### **Configure Credentials** Before adding nodes to the production workflow, it is recommended to create TalorData credentials: * Open Credentials in n8n. * Create new credentials and select Talordata SERP API. * Paste your TalorData SERP API Key. * Unless you are testing an internal development environment, keep the default endpoint. * Save or test the credential. {% hint style="success" icon="filter" %} Both credential testing requests and workflow execution requests send the following source identifier to TalorData for platform usage statistics: {% endhint %} ``` Origin: n8n ``` {% endstep %} {% step %} #### **Create Your First Workflow** Run a TalorData search in n8n: * Create a new workflow or open an existing one. * Add the Talordata SERP node. * Select your Talordata SERP API credentials. * Select an operation, such as Google Search. * Fill in the fields displayed for the operation. * Execute the node. The node returns the TalorData SERP JSON response along with request metadata for the selected operation. You can pass the output to downstream n8n nodes, such as AI Agents, Code nodes, databases, spreadsheets, notification services, or reporting tools. {% endstep %} {% endstepper %} ### Example: Google Search You can use this action when you need to retrieve standard web search results from Google. ``` Operation: Google Search Search Query: coffee Country/Region: United States Language: English Number of results: 10 ``` {% hint style="info" icon="sliders-simple" %} Typical use cases include market research, SEO monitoring, competitor analysis, and retrieval-augmented AI workflows. {% endhint %} ### Example: Bing Image Search This action can be used when the workflow needs to retrieve image search results from Bing. ``` Operation: Bing Image Search Search Query: coffee Country/Region: United States Market: en-US Result count: 10 ``` ### Example: Google Lens Search Google Lens Search can be used when the workflow takes an image URL as input. ``` Operation: Google Lens Search Image URL: https://example.com/image.png ``` ### Example: Yandex Search Yandex Search can be used when a workflow requires Yandex SERP results. ``` Operation: Yandex Search Search Query: coffee ``` ### Advanced Usage: Raw SERP Request You can use a Raw SERP Request when you want to select a pre-generated SERP action while manually passing advanced parameters. ``` Operation: Raw SERP Request Raw Action: Google Lens Search Raw Query: https://example.com/image.png Extra Parameters JSON: {"hl":"en"} ``` The node automatically uses the correct query field based on the selected action—such as `q`、`text`、`url`、`product_id`、`patent_id`、`author_id` or `trend`。 {% hint style="warning" %} The Extra Parameters JSONmust be a valid JSON object. This field is merged into the request after the visible form fields. The node controls the `engine` and the default `json=2` value, so extra parameters cannot override the selected search engine. {% endhint %} ### Supported operations Talordata SERP nodes expose SERP actions generated from TalorData metadata. The list of actions includes:
| Sort | Supported operations |
|---|---|
| Web Search | Google Search、Bing Search、DuckDuckGo Search、Yandex Search |
| Image | Google Images、Bing Images、Google Lens |
| News | Google News、Bing News |
| E-commerce | Google Shopping、Google Play |
| Research | Google Scholar、Google Patents |
| Local & Travel | Google Maps、Google Hotels、Google Flights |
| Market and Trend Data | Google Finance、Google Trends |
Residential proxy IPs correspond to physical devices distributed worldwide and are real IP resources assigned by Internet Service Providers (ISPs). This high level of anonymity makes every access appear as if it is being performed by a real user.
Country/Region Code, use the two-letter country code format, case-insensitive. This parameter is omitted for random regions. For example:
DE represents Germany, GB represents the United Kingdom, IT represents Italy.
| | protocol | Proxy Protocol (http) | | return\_type | Data Format: txt/JSON | | lb | Delimiters: (1:\r\n 2:/br 3:\r 4:\n 5:\t ) | | num | Number of IPs to Extract | # Mobile Proxies Mobile Proxies assign real mobile network IPs to your devices, hiding your real IP address and making your network requests appear to originate from a mobile connection (3G/4G/5G). Mobile Proxies are easy to configure and support **country-level targeting**, with full 3G/4G/5G connection compatibility. For more details, visit TalorData or contact contact our official support team. # Qucik Start supportIn just a few simple steps, you can easily set up and run your mobile proxies. Follow the steps below to create your mobile proxies. *** ### Get Your Credentials {% hint style="success" icon="lightbulb-exclamation-on" %} Before using the service, you need to set up your authentication credentials. {% endhint %} {% stepper %} {% step %} Login account {% endstep %} {% step %} In the dashboard, click **Mobile Proxies → Account List.**