> For the complete documentation index, see [llms.txt](https://help.netnut.io/netnut-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-images/introduction-to-google-images-scraper.md).

# Introduction to Google Images Scraper

The **Google Images API** provides programmatic access to Google Images search results through a unified endpoint

It enables you to retrieve structured image results, including titles, source pages, image URLs, thumbnails, and pagination data using our SERP-API.

This API is designed for **image discovery, content research, brand monitoring and visual analysis workflows,** supporting advanced filtering, sorting and localization.

### Authentication[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#authentication) <a href="#authentication" id="authentication"></a>

To access the SERP API, you must provide basic authentication credentials using the username and password provided by NetNut. Include these credentials in the HTTP request headers as follows:

`Authorization: Basic base64(username:password)`

Where base64(username:password) is the Base64-encoded string of your username and password concatenated with a colon (`:`) separator.

### Environments[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#environments) <a href="#environments" id="environments"></a>

* Base URL: `https://serp-api.netnut.io`
* Endpoint: `/search&udm=28`

### API Parameters & Specifications[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#api-parameters--specifications) <a href="#api-parameters--specifications" id="api-parameters--specifications"></a>

#### &#x20;Search Query[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#----search-query-) <a href="#search-query" id="search-query"></a>

| Name | Status   | Description                                                                                                                                                             |
| ---- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `q`  | Required | The 'q' parameter defines the query you want to search for. You can use any string that you would use in a regular Google search (e.g., `inurl:`, `site:`, `intitle:`). |

#### &#x20;Pagination[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--pagination-) <a href="#pagination" id="pagination"></a>

| Name    | Status   | Description                                                                                                                                                                                                                                                                                                                                                                                             |
| ------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `start` | Optional | <p>The <code>start</code> parameter controls the result offset used for pagination. <br>It specifies how many results to skip before returning data. For example, <code>start=0</code> (default) returns the first page, <code>start=10</code> returns the second page, <code>start=20</code> returns the third page, and so on. <br><strong>The parameter supports increments of 10 only</strong>.</p> |

#### &#x20;Geographic Location[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--geographic-location--) <a href="#geographic-location" id="geographic-location"></a>

| Name   | Status   | Description                                                                                                                                                                     |
| ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uule` | Optional | The 'uule' parameter is the Google encoded location you want to use for performing the Google search. [**Click here** ](https://indexguru.com/uule-generator)to generate a UULE |

#### &#x20;Localization[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--localization--) <a href="#localization" id="localization"></a>

| Name           | Status   | Description                                                                                                                                                                                                                                                                                                |
| -------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `googleDomain` | Optional | <p>The <code>googleDomain</code> parameter defines the Google domain to use for the Google search. The default is <code>[www.google.com](http://www.google.com)</code>. <br>Please ensure you add "www" before the domain name.</p>                                                                        |
| `gl`           | Optional | The `gl` parameter defines the country to use for the Google search. It is a two-letter country code. For example - use `us` for the United States, `uk` for United Kingdom, etc.                                                                                                                          |
| `hl`           | Optional | The `hl` parameter defines the language to use for the Google search. It is a two-letter language code. For example - use `en` for English, `de` for German, etc. [**Access** ](https://cloud.google.com/translate/docs/languages)the Google languages page for a full list of supported Google languages. |
| `location`     | Optional | <p>Similarly to the  <code>gl</code> parameter it is another parameter  that defines the country to use for the Google search. <br>It is a two-letter country code. For example - use <code>us</code> for the United States, <code>uk</code> for United Kingdom, etc.</p>                                  |

#### &#x20;Advanced Filters[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#--advanced-filters--) <a href="#advanced-filters" id="advanced-filters"></a>

<table><thead><tr><th>Name</th><th width="222">Status</th><th>Description</th></tr></thead><tbody><tr><td><code>rawHtml</code></td><td>Optional</td><td>The 'rawHtml' parameter defines the final output you want. It can be set to <code>1 (true)</code> or <code>0 (false)</code> to get the raw html response.<br>for receiving html only (without parsing) set it to <code>2 (only)</code></td></tr><tr><td><code>tbs</code></td><td>Optional</td><td>This parameter specifies additional filtering to the results. <br>Additional info in the dedicated <code>tbs</code> table </td></tr><tr><td><code>safe</code></td><td>Optional</td><td>The 'safe' parameter defines the level of filtering for adult content. It can be set to <code>active</code> or <code>off</code>, by default Google blurs explicit content.</td></tr><tr><td><code>filter</code></td><td>Optional</td><td>The 'filter' parameter allows defining whether the filters for 'Omitted Results' and 'Similar Results' are enabled or disabled. Setting the parameter to <code>1</code> (default) enables these filters, and setting the parameter to <code>0</code> disables these filters.</td></tr><tr><td><code>nfpr</code></td><td>Optional</td><td>Parameter defines the exclusion of results from an auto-corrected query that is spelled wrong. It can be set to <code>1</code> to exclude these results, or <code>0</code> to include them (default).</td></tr><tr><td><code>device</code></td><td>Optional</td><td>The 'device' parameter defines the device to use to get the Google search results. The parameter can be set to <code>desktop</code> (default) to use a regular browser, tablet to use a tablet browser (currently using iPads), or <code>mobile</code> to use a mobile browser (currently using iPhones).</td></tr></tbody></table>

### `tbs` common filters <a href="#api-results-http-response" id="api-results-http-response"></a>

<table><thead><tr><th>Name</th><th width="222">Status</th><th>Description</th></tr></thead><tbody><tr><td>Image Size - <code>isz</code>          </td><td>Optional</td><td><p>Filters results by image size. Examples: </p><ul><li><code>isz:l</code> (large images)</li><li><code>isz:m</code> (medium)</li><li><code>isz:i</code> (icons)</li></ul><p>Advanced thresholds are supported via combined keys, for example <code>isz:lt,islt:2mp</code> (larger than 2MP), <code>isz:lt,islt:10mp</code> (larger than 10MP).</p></td></tr><tr><td>Color Filter - <code>ic</code></td><td>Optional</td><td><p>Filters images by color characteristics. </p><p>Examples: </p><ul><li><code>ic:color</code> (full color)</li><li><code>ic:gray</code> (black and white)</li><li> <code>ic:trans</code> (transparent background)</li></ul><p> Specific colors are supported using <code>ic:specific,isc:&#x3C;color></code>, for For example: <code>ic:specific,isc:blue</code>, <code>ic:specific,isc:red</code>.</p></td></tr><tr><td>Image Type - <code>itp</code></td><td>Optional</td><td><p>Restricts results to a specific image type. </p><p>Examples: </p><ul><li><code>itp:photo</code> (photographs)</li><li><code>itp:clipart</code> (illustrations)</li><li> <code>itp:lineart</code> (line drawings)</li><li><code>itp:animated</code> (GIFs)</li><li> <code>itp:face</code> (faces)</li></ul></td></tr><tr><td>Usage Rights - <code>sur</code></td><td>Optional</td><td><p>Filters images by usage and licensing rights. </p><p>Examples: </p><ul><li><code>sur:f</code> (free to use or share)</li><li><code>sur:fc</code> (free to use commercially)</li><li><code>sur:fm</code> (free to modify)</li><li><code>sur:fmc</code> (free to modify commercially)</li></ul></td></tr><tr><td>Time Range - <code>qdr</code></td><td>Optional</td><td><p>Limits results by recency. </p><p>Examples: </p><ul><li><code>qdr:d</code> (past 24 hours)</li><li><code>qdr:w</code> (past week)</li><li><code>qdr:m</code> (past month)</li><li><code>qdr:y</code> (past year)</li></ul></td></tr><tr><td>Aspect Ratio - <code>iar</code></td><td>Optional</td><td><p>Filters images by aspect ratio.</p><p> Examples: </p><ul><li><code>iar:s</code> (square)</li><li><code>iar:t</code> (tall)</li><li><code>iar:w</code> (wide)</li><li><code>iar:xw</code> (extra wide)</li></ul></td></tr><tr><td>File Type - <code>ift</code></td><td>Optional</td><td><p>Restricts results to specific image file formats. </p><p>Examples: </p><ul><li><code>ift:jpg</code></li><li><code>ift:png</code></li><li><code>ift:gif</code></li><li><code>ift:webp</code></li><li><code>ift:svg</code></li><li><code>ift:bmp</code></li></ul></td></tr></tbody></table>

### API Results structure[​](https://serp-api.netnut.io/docs/SERP/Getting%20Started#api-results-http-response) <a href="#api-results-http-response" id="api-results-http-response"></a>

```json
{
  "url": "string",
  "general": {
    "searchEngine": "google_images",
    "language": "string",
    "device": "string",
    "searchType": "string",
    "pageTitle": "string",
    "timestamp": "string"
  },
  "input": {
    "originalUrl": "string",
    "jobId": "string"
  },
  "images": [
    {
      "title": "string",
      "source": "string",
      "thumbnail": "string",
      "link": "string",
      "original": "string",
      "originalWidth": 0,
      "originalHeight": 0,
      "rank": 0
    }
  ],
  "pagination": {
    "currentPage": 0,
    "nextPage": 0,
    "nextPageLink": "string",
    "nextPageStart": 0
  }
}

```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.netnut.io/netnut-documentation/netnut-scraper-apis/serp-api/google-scraper/google-images/introduction-to-google-images-scraper.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.