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