> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/scraping/serp-api/query-parameters/google/google-lens.md).

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