Google Images

Search Images

get/images

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/images
  • Auth: API key in header X-API-KEY

Query parameters

qstring required

Required

hlstring nullable

Localization

glstring nullable

ISO 3166-1 alpha-2 country code for geo-targeting (e.g., us, de, uk, jp). Prioritizes images from websites in the specified country.

imgsz'large' | 'medium' | 'icon' | 'null' nullable

Image Filters

imgtype'photo' | 'clipart' | 'lineart' | 'gif' | 'face' | 'null' nullable

Filter by image type. Accepted values: photo (photographs), clipart (clip art), lineart (line drawings), gif (animated GIFs), face (images containing faces).

imgcolor'color' | 'gray' | 'trans' | 'red' | 'orange' | 'yellow' | 'green' | 'teal' | 'blue' | 'purple' | 'pink' | 'white' | 'black' | 'brown' | 'null' nullable

Filter by dominant color. Accepted values: color, gray, trans (transparent), red, orange, yellow, green, teal, blue, purple, pink, white, black, brown.

imgar'tall' | 'square' | 'wide' | 'null' nullable

Filter by aspect ratio. Accepted values: tall (portrait orientation), square (1:1 ratio), wide (landscape orientation).

tbsstring nullable

Advanced Google filter string (e.g. isz:l to restrict to large images).

safe'active' | 'off' | 'null' nullable

Safe search filtering. Accepted values: active (filter explicit content), off (no filtering). Recommended to set active for public-facing applications.

pageinteger nullable

Pagination

Response

object required

Changes

No recorded changes to this operation across all 3 revisions of this API.