Google Images
Search Google Images via API and retrieve image results (URLs, titles, sources, dimensions).
Credit cost: 1 credit per call
ApiKeyAuthx-api-key<token>Your API key. Include it in the x-api-key header for every request.
query*stringQuery you want to search on Google Images (e.g. "lion", "nike logo", "modern house exterior").
page?numberPage number for pagination (1 = first page).
"1"google_domain?stringGoogle domain to use for the search. Defaults to google.com.
Examples:
google.comgoogle.co.ukgoogle.fr
Example:
google.com"google.com"gl?stringCountry to use for the Google search. Two-letter country code (e.g. us for the United States, uk for United Kingdom, or fr for France).
Example:
ushl?stringLanguage to use for the Google search. Two or three-letter language code (e.g. en, es, fr), optionally followed by a region code (e.g. en-gb, es-419).
Example:
encr?stringLimit results to one or more countries. Use country{XX} with | as delimiter (e.g. countryFR|countryDE).
Example:
countryUSlr?stringLimit results to one or more languages. Use lang_{xx} with | as delimiter (e.g. lang_fr|lang_de).
Example:
lang_enasync?booleanIf true, returns a job and lets you fetch results asynchronously.
falsesafe?stringAdult content filter. active enables Google SafeSearch; off disables it. Omit to use Google default.
fields?stringComma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).
is_async?booleanRun the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.
falsesoft_fail?booleanReturn HTTP 200 even when the request fails; the error is in the error field of the body.
falseSuccessful response
application/json- response
images?array<>search_parameters?curl -X GET 'https://api.autom.dev/v1/google/images?query=string'{ "images": [ { "url": "https://upload.wikimedia.org/wikipedia/commons/thumb/7/73/Lion_waiting_in_Namibia.jpg/1200px-Lion_waiting_in_Namibia.jpg", "link": "https://en.wikipedia.org/wiki/Lion", "title": "Lion - Wikipedia", "domain": "en.wikipedia.org", "source": "Wikipedia", "position": 1, "image_width": 1200, "image_height": 900 } ], "search_parameters": { "q": "lion", "gl": "us", "hl": "en", "page": 1, "engine": "google" }}