# Google Lens

#### SERP API Google Query Parameters

Configure Google search queries using Thordata’s SERP API, including localization parameters, seach type,  and advanced parameter output options.

<details>

<summary><code>url</code> <strong>,</strong>Image URL<strong>(Required)</strong></summary>

Parameter defines the URL of an image to perform the Google Lens search.

<https://i.imgur.com/HBrB8p0.png>

**Example Request:**\
Example using the parameter `url`: `https://i.imgur.com/HBrB8p0.png`

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1"
```

</details>

## Localization

<details>

<summary><code>country</code> <strong>,</strong>Country<strong>(Optional)</strong></summary>

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` : <mark style="color:blue;">pizza</mark>,`country`: <mark style="color:blue;">ru</mark>

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "gl=ru" \
 -d "json=1"
```

</details>

<details>

<summary><strong><code>hl</code> ,</strong>Language<strong>(Optional)</strong></summary>

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`url`: `https://i.imgur.com/HBrB8p0.png`,`hl`: <mark style="color:blue;">es</mark>

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1" \
 -d "hl=es"
```

</details>

## Search Types

<details>

<summary><code>type</code> <strong>,</strong>Type of search<strong>(Optional)</strong></summary>

The parameter defines the type of search to be performed. By default, the search type is all.

Available options:

`all` - All

`products` - Products

`exact_matches` - Exact Match

`visual_matches` - Visual Match.

**Example Request:**

Example results for`url`: `https://i.imgur.com/HBrB8p0.png`,`type`: products

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1" \
 -d "type=products"
```

</details>

## Advanced Parameters

<details>

<summary><code>q</code> <strong>,</strong>Search Query<strong>(Optional)</strong></summary>

The parameter defines the search query to be used in Google Lens searches. Applicable only when type is set to all, products, visual\_matches.

**Example Request:**

Example results for`url`: `https://i.imgur.com/HBrB8p0.png`,`q`: acting

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_lens" \
 -d "url=https://i.imgur.com/HBrB8p0.png" \
 -d "json=1" \
 -d "q=acting" \
 -d "type=all"
```

</details>

<details>

<summary><strong><code>safe</code> ,</strong>Adult Content Filtering<strong>(Optional)</strong></summary>

Filters adult content:

* `safe=active` – Strict filtering (default)
* `safe=off` – No filtering

**Example Request:**

Example results for`url`: `https://i.imgur.com/HBrB8p0.png`,**`safe`**: active

```sh
curl -X POST https://scraperapi.thordata.com/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"
```

</details>

For further assistance, contact us at **<support@thordata.com>**.


---

# 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/query-parameters/google/google-lens.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.