# Google Images

#### SERP API Google Query Parameters

Configure GoogleImages queries using Thordata’s SERP API, including localization parameters, geotargeting, Time period,pagination, and "advanced parameter"  output options.

<details>

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

Define the search query used for data crawling (default value: `q=pizza`). Any keywords in any language are supported.

**Example Request:**\
Example with `q`:<mark style="color:blue;">pizza</mark> parameter

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1"
```

</details>

## Localization

<details>

<summary><code>google_domain</code><strong>,</strong>Domain<strong>(Optional)</strong></summary>

Defines the domain used for scraping. Default: `google.com`.&#x20;

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` : <mark style="color:blue;">pizza</mark> ,`google_domain`: <mark style="color:blue;">google.co.ao</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_images" \
 -d "q=pizza" \
 -d "google_domain=google.co.ao" \
 -d "json=1"
```

</details>

<details>

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

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` : <mark style="color:blue;">pizza</mark>,`gl`: <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_images" \
 -d "q=pizza" \
 -d "gl=ru" \
 -d "json=1"
```

</details>

<details>

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

Sets the UI language for search results (default: `en`). Uses a two-letter language code (e.g., `en`, `es`, `zh-CN`).

&#x20;Full list: [Google Language Codes](https://developers.google.com/google-ads/api/docs/start).

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`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_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"
```

</details>

<details>

<summary><strong><code>cr</code> ,</strong>Set Multiple Countries<strong>(Optional)</strong></summary>

Restricts results to specific countries using `|` as a separator (e.g., `countryFR|countryDE`). Combine with `gl` for consistent UI/content language.

`gl` and `cr` can be combined, but the actual effect follows **`cr`** as the priority.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`cr`: <mark style="color:blue;">countryFR|countryDE</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_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "cr=countryAI|countryAQ"
```

</details>

## Geotargeting

<details>

<summary><strong><code>location</code> ,</strong>Location<strong>(Optional)</strong></summary>

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` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</mark>

```
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
```

</details>

<details>

<summary><strong><code>uule</code> ,</strong>Encoded Location<strong>(Optional)</strong></summary>

Encodes the target location via Base64. Use with `location`.&#x20;

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</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_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
```

</details>

## Time period

<details>

<summary><code>period_unit</code> <strong>,</strong>Time Period Unit<strong>(Optional)</strong></summary>

Parameter defines the time period unit to search for the recent images, e.g. from past minute, hour, day etc.\
\
Options:\
`s` - Second\
`n` - Minute\
`h` - Hour\
`d` - Day\
`w` - Week\
`m` - Month\
`y` - Year

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`period_unit`:h

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "period_unit=h"
```

</details>

<details>

<summary><code>period_value</code> <strong>,</strong>period_value<strong>(Optional)</strong></summary>

Parameter defines an optional time period value that can be used with `period_unit` to describe time periods like `15 seconds`, `42 hours`, `178 days` etc.\
\
Default value: `1`\
Value range: `1..2147483647`

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`period_value` :178 day

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "period_value=178 day"
```

</details>

<details>

<summary><code>start_date</code>,Start Date<strong>(Optional)</strong></summary>

Sets the number of results per page (default: `20`).

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`start_date:`20250801

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "start_date=20250801"
```

</details>

<details>

<summary><code>end_date</code> <strong>,</strong>End Date<strong>(Optional)</strong></summary>

Parameter defines the end date of time period you want to limit the image search to.\
\
Format: `YYYYMMDD`\
Example: `20241231`

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`end_date`:20250801

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "end_date=20250801"
```

</details>

## Pagination

<details>

<summary><code>ijn</code> <strong>,</strong>Page Number (images)<strong>(Optional)</strong></summary>

Parameter defines the page number for [Google Images](https://serpapi.com/images-results). There are 100 images per page. This parameter is equivalent to start (offset) = ijn \* 100.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`ijn`:<mark style="color:blue;">100</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_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "ijn=100"
```

</details>

## Advanced Filters

<details>

<summary><strong><code>chips</code>，</strong>Image search filter (alternative)<strong>(Optional)</strong></summary>

Parameter enables to filter image search. It's a string provided by Google as suggested search, like: red apple. Chips are provided under the section: `suggested_searches` when `ijn = 0`. Both `chips` and `serpapi_link` values are provided for each suggested search.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,**`chips`**:size

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "end_date=20250801" \
 -d "chips=size"
```

</details>

<details>

<summary><strong><code>tbs</code> ，</strong>Advanced Search Parameters<strong>(Optional)</strong></summary>

(to be searched) parameter defines advanced search parameters that aren't possible in the regular query field.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,**`tbs`**:sur:f

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "tbs=sur:f"
```

</details>

<details>

<summary><strong><code>imgar</code>，</strong>Aspect Ratio Filtering<strong>(Optional)</strong></summary>

\
Parameter defines the set aspect ratio of images.\
\
Options:\
`s` - Square\
`t` - Tall\
`w` - Wide\
`xw` - Panoramic

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,**`imgar`**:s

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "imgar=s"
```

</details>

<details>

<summary><strong><code>imgsz</code> ，</strong>Image Size Filtering<strong>(Optional)</strong></summary>

\
Parameter defines the size of images.\
\
Options:\
`l` - Large\
`m` - Medium\
`i` - Icon\
`qsvga` - Larger than 400×300\
`vga` - Larger than 640×480\
`svga` - Larger than 800×600\
`xga` - Larger than 1024×768\
`2mp` - Larger than 2 MP\
`4mp` - Larger than 4 MP\
`6mp` - Larger than 6 MP\
`8mp` - Larger than 8 MP\
`10mp` - Larger than 10 MP\
`12mp` - Larger than 12 MP\
`15mp` - Larger than 15 MP\
`20mp` - Larger than 20 MP\
`40mp` - Larger than 40 MP

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,**`imgsz`**:qsvga

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "imgsz=qsvga"
```

</details>

<details>

<summary><strong><code>image_color</code> ，</strong>Image Color Filtering<strong>(Optional)</strong></summary>

\
Parameter defines the color of images.\
\
Options:\
`bw` - Black and white\
`trans` - Transparent\
`red` - Red\
`orange` - Orange\
`yellow` - Yellow\
`green` - Green\
`teal` - Teal\
`blue` - Blue\
`purple` - Purple\
`pink` - Pink\
`white` - White\
`gray` - Gray\
`black` - Black

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,**`image_color`**:animated

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "image_type=animated"
```

</details>

<details>

<summary><strong><code>image_type</code>，</strong>Image Type Filtering<strong>(Optional)</strong></summary>

\
Parameter defines the type of images.\
\
Options:\
`face` - Face\
`photo` - Photo\
`clipart` - Clip art\
`lineart` - Line drawing\
`animated` - Animated

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,**`image_type`**:face

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "image_type=face"
```

</details>

<details>

<summary><strong><code>licenses</code> ，</strong>Usage Rights Filterin<strong>(Optional)</strong></summary>

Parameter defines the scope of licenses of images.\
\
Options:\
`f` - Free to use or share\
`fc` - Free to use or share, even commercially\
`fm` - Free to use, share or modify\
`fmc` - Free to use, share or modify, even commercially\
`cl` - Creative Commons licenses\
`ol` - Commercial and other licenses

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,**`licenses`**:f

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "licenses=f"
```

</details>

<details>

<summary><strong><code>safe</code> ，</strong>Safe<strong>(Optional)</strong></summary>

Parameter defines the level of filtering for adult content. It can be set to `active` or `off`, by default Google will blur explicit content.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>`safe`:<mark style="color:blue;">active</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_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "safe=active"
```

</details>

<details>

<summary><strong><code>nfpr</code> ，</strong>Exclude Auto-corrected Results<strong>(Optional)</strong></summary>

Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to `1` to exclude these results, or `0` to include them (default). Note that this parameter may not prevent Google from returning results for an auto-corrected query if no other results are available.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`nfpr`:<mark style="color:blue;">1</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_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "nfpr=1"
```

</details>

<details>

<summary><strong><code>filter</code> ，</strong>Results Filtering<strong>(Optional)</strong></summary>

\
Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to `1` (default) to enable these filters, or `0` to disable these filters.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>`filter`:1

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_images" \
 -d "q=pizza" \
 -d "json=1" \
 -d "filter=1"
```

</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-images.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.