Google Images
Google's Images tab for a query: a hundred pictures with their source page, the suggestion chips above the grid and a `pagination.next`.
Google's Images tab for a query: a hundred pictures with their source page, the suggestion chips above the grid and a pagination.next. Answers the document: search_metadata, search_parameters, search_information, images, suggestions, related_searches (the tab usually has none) and pagination. The picture's own address (original, with its width and height) is not answered: Google's page holds the grid and each item's source page but not that address, which comes in a request the page makes when an item is opened. page above 1 is a 400 (a plain load gets the first hundred images and no stable second batch). Desktop only.
X-API-Key<token>Your API key.
cancel_token?stringA name you make up for this request (a UUID is fine), so you can later GET /v1/cancel
with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.
1 <= length <= 128q*stringWhat to search for.
1 <= lengthlocation?stringA canonical place name, e.g. "Austin,Texas,United States" (becomes Google's uule). Not with uule.
uule?stringGoogle's own location value (w+CAIQ...). Not with location.
gl?stringCountry of the search, two letters.
"us"hl?stringInterface language, e.g. en, pt-br.
"en"device?"desktop"Only desktop: mobile and tablet are a 400.
"desktop""desktop"lr?stringLanguage of the documents, lang_fr or several lang_it|lang_de.
cr?stringCountry of the documents, countryFR or several countryFR|countryDE.
nfpr?string1 leaves out results for an auto-corrected spelling.
"0""0""1"filter?string0 turns off Google's duplicate-content and host-crowding filters.
"1""0""1"safe?stringAdult-content filtering.
"blur""active""blur""off"time_period?stringOnly pictures from this period.
"last_hour""last_day""last_week""last_month""last_year"size?stringlarge (isz:l), medium, icon, or larger_than_400x300, larger_than_640x480, larger_than_800x600, larger_than_1024x768, larger_than_2mp ... larger_than_70mp. Outside the list is a 400.
color?stringColour filter.
"color""black_and_white""transparent""red""orange""yellow""green""teal""blue""purple""pink""white""gray""black""brown"image_type?stringKind of picture.
"clipart""line_drawing""gif""face""photo"usage_rights?stringLicence filter.
"creative_commons_licenses""commercial_or_other_licenses"aspect_ratio?stringShape of the picture.
"square""tall""wide""panoramic"tbs?stringGoogle's tbs as the caller writes it; not with the filter parameters.
page?integerOnly 1: above 1 is a 400.
1 <= value <= 11The results page, as the document. When the page could not be parsed, the usual envelope.
application/json- response
The Images document. A block is present only when the page has it.
search_metadata?search_parameters?The request as sent, with the defaults that were used.
search_information?suggestions?array<>The chips above the grid.
images?array<>A page holds 100.
related_searches?array<>The tab usually has none.
pagination?[key: string]?anycurl -X GET 'https://api.justserp.com/v1/google/images?q=golden+gate+bridge'{ "search_metadata": { "id": "string", "status": "string", "created_at": "string", "request_url": "string", "html_url": "string" }, "search_parameters": {}, "search_information": { "query_displayed": "string" }, "suggestions": [ { "title": "string", "link": "string" } ], "images": [ { "position": 0, "title": "string", "source": { "name": "string", "link": "string" }, "thumbnail": "string" } ], "related_searches": [ { "query": "string", "link": "string" } ], "pagination": { "current": 0, "next": "string" }}