# SERP API Google Query Parameters

Understand the query parameters for Thordata’s SERP API - Google Search.

**Search Term**
\
Example:

```sh
curl -k "https://www.google.com/search?q=pizza" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="100">Parameter</th><th width="140">Name</th><th width="290">Function</th><th>Parameter Value</th></tr></thead><tbody><tr><td>q</td><td>Search Term</td><td>Specify search keywords</td><td>q=pizza</td></tr></tbody></table>

**Localization**
\
Used to specify the language and locale of the search results.
\
Example:

```sh
curl -k "https://www.google.ac/search?q=pizza&gl=af&hl=ach" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="100">Parameter</th><th width="139">Name</th><th width="290">Function</th><th>Parameter Value</th></tr></thead><tbody><tr><td>hl</td><td>Language</td><td>Specify the display language of the search results interface</td><td>hl=en，hl=zh-CN...</td></tr><tr><td>gl</td><td>Country</td><td>Specify the display of search results according to the habits of users in that country.</td><td>gl=US，gl=CN...</td></tr></tbody></table>

**Location**
\
Specifies the geocoded location of the search, altering the geographic context. You can download a file of all available values here.
\
Example:

```sh
curl -k "https://www.google.ac/search?q=pizza&uule=w+CAIQICIXS2FidWwsS2FidWwsQWZnaGFuaXN0YW4" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="100">Parameter</th><th width="132">Name</th><th width="290">Function</th><th>Parameter Value</th></tr></thead><tbody><tr><td>uule</td><td>Location</td><td>Specify precise geographic location based on coordinates (Base64 encoded)</td><td>uule=w+CAIQICINVW5pdGVkIFN0YXRlcw</td></tr></tbody></table>

**Search Type**
\
Used to define the type of search. No tbm parameter is required for general search, but each other type uses a specific tbm value.
\
Example:

```sh
curl -k "https://www.google.ac/search?q=pizza&tbm=isch" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="100">Parameter</th><th width="143">Name</th><th width="283">Function</th><th>Parameter Value</th></tr></thead><tbody><tr><td>tbm</td><td>Search type</td><td>Specify search type</td><td>tbm=nws
<br>tbm=vid
<br>tbm=isch
<br>tbm=shop</td></tr></tbody></table>

**Pagination**
\
Used to set result offset and number of results to return.
\
Example:

```sh
curl -k "https://www.google.ac/search?q=pizza&start=10&num=100" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="100">Parameter</th><th width="150">Name</th><th width="271">Function</th><th>Parameter Value</th></tr></thead><tbody><tr><td>start</td><td>Pagination</td><td>Specify search page number (offset)</td><td>start=10 (Display page 2) /00/10.../100</td></tr><tr><td>num</td><td>Results per page</td><td>Specify the number of results per search page</td><td>num=100 (Up to 100 results) 1....100</td></tr></tbody></table>

**Safe Search**
\
Used to control whether explicit/adult content is filtered.
\
Example:

```sh
curl -k "https://www.google.ac/search?q=pizza&safe=active" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="100">Parameter</th><th width="160">Name</th><th width="263">Function</th><th>Parameter Value</th></tr></thead><tbody><tr><td>safe</td><td>Safe</td><td>Mainly used to block explicit adult content (such as pornography, violence, etc.)</td><td>safe=active
<br>safe=off</td></tr></tbody></table>

**Parsing**
\
A Thordata custom parameter that allows you to receive a parsed JSON result instead of raw HTML.
\
Example:

```sh
curl -k "https://www.google.ac/search?q=pizza&json=1" --proxy scraping.thordata.com:30001 --proxy-user td-customer-serp_USERNAME:PASSWORD
```

<table><thead><tr><th width="102">Parameter</th><th width="168">Name</th><th width="209">Function</th><th>Parameter Value</th></tr></thead><tbody><tr><td>json</td><td>Parsing</td><td>Specify output format</td><td>No json value (returns HTML)
<br>json=1 (returns JSON)
<br>json=2 (returns JSON + HTML)</td></tr></tbody></table>