Google Images

Search

Get Google images Search data, including image URLs and metadata, for filtered image discovery for research and monitoring workflows.

get/api/v1/google/images/search

Request

  • Base URL: http://api.justserpapi.com
  • URL: http://api.justserpapi.com/api/v1/google/images/search
  • Auth: none declared

Query parameters

querystring required

The search query for images (e.g., 'mountain landscape', 'luxury cars').

htmlboolean

Set to true to return the raw HTML of the Google search results page alongside the structured data.

pageinteger

The results page number. Use 0 for the first page, 1 for the second, and so on.

domainstring

The Google domain to use for the search (e.g., 'google.com', 'google.co.uk'). See <a href="/reference/google-domains">Google Domains</a>.

countrystring

Set the target country code (e.g., 'us', 'uk') to localize results. See <a href="/reference/google-countries">Google Countries</a>.

crstring

Limits results to search results from specific countries. Format: 'countryXX'. See <a href="/reference/google-cr-countries">Google CR Countries</a>.

languagestring

Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See <a href="/reference/google-language">Google Language</a>.

lrstring

Restrict results to one or more languages using the 'lang_{language_code}' format (e.g., 'lang_en'). See <a href="/reference/google-lr-language">Google LR Language</a>.

uulestring

Encoded location string (UULE) used to precisely localize Google search results. This is an advanced/technical parameter — if you’re not familiar with it, you can leave it empty and omit it.

period_unit'SECOND' | 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR'

Google Images recent-result time unit.

Time unit for recent image results.

Available Values:

  • SECOND: Second. Legacy value s is also accepted.
  • MINUTE: Minute. Legacy value n is also accepted.
  • HOUR: Hour. Legacy value h is also accepted.
  • DAY: Day. Legacy value d is also accepted.
  • WEEK: Week. Legacy value w is also accepted.
  • MONTH: Month. Legacy value m is also accepted.
  • YEAR: Year. Legacy value y is also accepted.
period_valuestring

Time duration value used with 'period_unit' (e.g., 15 for 15 days). Default: 1.

start_datestring

Start date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241201').

end_datestring

End date for restricting images to a time range. Format: 'YYYYMMDD' (e.g., '20241231').

chipsstring

Additional suggested search terms (chips) to filter images. Values are obtained from previous responses.

tbsstring

Advanced search filter parameter (tbs) used to apply Google result filters (e.g. time range). This is an advanced parameter — if you’re not familiar with it, you can leave it empty.

imgar'SQUARE' | 'TALL' | 'WIDE' | 'PANORAMIC'

Google Images aspect-ratio filter.

Filter by image aspect ratio.

Available Values:

  • SQUARE: Square images. Legacy value s is also accepted.
  • TALL: Tall images. Legacy value t is also accepted.
  • WIDE: Wide images. Legacy value w is also accepted.
  • PANORAMIC: Panoramic images. Legacy value xw is also accepted.
imgsz'LARGE' | 'MEDIUM' | 'ICON'

Google Images size filter.

Filter by image size.

Available Values:

  • LARGE: Large images. Legacy value l is also accepted.
  • MEDIUM: Medium images. Legacy value m is also accepted.
  • ICON: Icon-sized images. Legacy value i is also accepted.
image_colorstring

Filter images by a dominant color (e.g., 'red', 'blue', 'bw' for black and white, 'trans' for transparent).

image_typestring

Filter by image type. Supported values: 'face', 'photo', 'clipart', 'lineart', 'animated'.

licenses'FREE_TO_USE' | 'COMMERCIAL_USE' | 'CREATIVE_COMMONS'

Google Images license filter.

Filter by usage rights and licenses.

Available Values:

  • FREE_TO_USE: Free to use. Legacy value f is also accepted.
  • COMMERCIAL_USE: Commercial use. Legacy value fc is also accepted.
  • CREATIVE_COMMONS: Creative Commons. Legacy value cl is also accepted.
safe'ACTIVE' | 'OFF'

Google SafeSearch filter setting.

SafeSearch filter setting.

Available Values:

  • ACTIVE: Filter adult content. Legacy value active is also accepted.
  • OFF: Disable SafeSearch filtering. Legacy value off is also accepted.
nfpr'INCLUDE_CORRECTED_RESULTS' | 'EXCLUDE_CORRECTED_RESULTS'

Google auto-correction setting.

Controls Google's auto-correction.

Available Values:

  • INCLUDE_CORRECTED_RESULTS: Include corrected results. Legacy value 0 is also accepted.
  • EXCLUDE_CORRECTED_RESULTS: Exclude corrected results. Legacy value 1 is also accepted.
filter'DISABLED' | 'ENABLED'

Google result filter toggle.

Toggle similar-results and omitted-results filtering.

Available Values:

  • DISABLED: Disable similar and omitted results filtering. Legacy value 0 is also accepted.
  • ENABLED: Enable similar and omitted results filtering. Legacy value 1 is also accepted.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.