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​

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​

• Base URL: https://serp-api.netnut.io

• Endpoint: /search&udm=28

API Parameters & Specifications​

Search Query​

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:).

Pagination​

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

Geographic Location​

Name	Status	Description
uule	Optional	The 'uule' parameter is the Google encoded location you want to use for performing the Google search. Click here to generate a UULE

Localization​

Name	Status	Description
googleDomain	Optional	The googleDomain parameter defines the Google domain to use for the Google search. The default is www.google.com. Please ensure you add "www" before the domain name.
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 the Google languages page for a full list of supported Google languages.
location	Optional	Similarly to the gl parameter it is another parameter that 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.

Advanced Filters​

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

tbs common filters

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

API Results structure​

{
  "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
  }
}