# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.thordata.com/doc/scraping/serp-api/serp-api-google-query-parameters.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.