Search APIs
Loading…
← API Store
Search & SEO

Google

Google

Google Images

GET /google/v1/images
Test this endpoint

Google Images results with the original image URL, size, thumbnail, dominant colour, source page, site and file size: about 100 per query (Google Images loads more only by infinite scroll, so next_start is null; narrow with the filters). Every /google/v1/search option applies. Every response includes credits_used: the credits this call cost.

Each call costs 6 credits; failed calls are free. Run it in the console playground to see a live result.

Parameters

NameTypeDescription
qrequiredstring Example: golden retriever
sizelarge | medium | icon | 2mp | 4mp | 8mp | 12mp | 20mplarge, medium, icon, 2mp, 4mp, 8mp, 12mp, 20mp (larger than).
colorstringcolor, grayscale, transparent, or a colour: red, orange, yellow, green, teal, blue, purple, pink, white, gray, black, brown.
image_typephoto | clipart | line | gif | facephoto, clipart, line, gif, face.
aspectsquare | tall | wide | panoramicsquare, tall, wide, panoramic.
licensecreative_commons | commercialcreative_commons or commercial.
image_formatjpg | png | gif | bmp | svg | webp | ico | rawjpg, png, gif, bmp, svg, webp, ico, raw.
timestringhour, day, week, month, year (or e.g. day_3).
countrystringResults country (gl), e.g. us, gb, de.
languagestringInterface language (hl), e.g. en, de.
locationstringCity/region to search from, e.g. Austin,Texas,United States.
google_domainstringe.g. google.co.uk.
safestringon or off.
limitintegerReturn at most this many images (default: all on the page).

Every endpoint also takes: raw、fields、fresh、output、records

No sample yet

This endpoint has no published sample. Use “Test this endpoint” to run it in the console playground.