Provides real-time access to Google image search results, tailored to specific parameters, ensuring efficient retrieval free from blocks or CAPTCHAs.

Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

Make Your First Request

curl --request GET \
  --url 'https://api.hasdata.com/scrape/google/images?q=Coffee&location=Austin%2CTexas%2CUnited%20States&deviceType=desktop' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

API Parameters

ParameterDefault ValueRequiredDescription
qCoffeeYesSearch query term for retrieving image results.
locationAustin,Texas,United StatesNoGoogle canonical location for the search.
uule-NoThe encoded location parameter.
domain-NoGoogle domain to use. Default is google.com.
gl-NoThe two-letter country code for the country you want to limit the search to.
hl-NoThe two-letter language code for the language you want to use for the search.
tbs-Notbs parameter for the Google Images API customizes image search results with various filters that can be combined using commas. Here are the available options:

Image Size Filters:
- isz:l - Search for large images.
- isz:m - Search for medium images.
- isz:i - Search for icon-sized images.
- isz:lt,islt:qsvga - Filter for images larger than 400×300.
- isz:lt,islt:vga - Filter for images larger than 640×480.
- isz:lt,islt:svga - Filter for images larger than 800×600.
- isz:lt,islt:xga - Filter for images larger than 1024×768.
- isz:lt,islt:2mp - Filter for images larger than 1600×1200.
- isz:lt,islt:4mp - Filter for images larger than 2272×1704.
- isz:ex,iszw:1000,iszh:1000 - Search for images exactly 1000×1000.

Color Filters:
- ic:color - Search for full-color images.
- ic:gray - Search for black and white images.
- ic:specific,isc:red (and other colors such as orange, yellow, green, etc.) - Search for images predominantly in specified colors.

Image Type Filters:
- itp:face - Search for images of faces.
- itp:photo - Search for photographs.
- itp:clipart - Search for clipart images.
- itp:lineart - Search for line drawings.
- itp:animated - Search for animated images (GIFs).
safe-NoAdult Content Filtering option.
filter-NoDefines whether to enable or disable the filters for ‘Similar Results’ and ‘Omitted Results’. Set to 1 (default) to enable these filters, or 0 to disable them.
deviceTypedesktopNoSpecify the device type for the search.
ijn-NoPage number for paginated results, where 0 is the first page.