Google Images
Search Google Images via API and retrieve image results (URLs, titles, sources, dimensions).
Credit cost: 1 credit per request
Authorization
ApiKeyAuth x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
Request Body
application/json
query*string
Query you want to search on Google Images (e.g. "lion", "nike logo", "modern house exterior").
page?number
Page number for pagination (1 = first page).
Default
"1"gl?string
Country to use for the search (two-letter country code, e.g. us, fr).
hl?string
Language to use for the search (two-letter language code, e.g. en, fr).
google_domains?string
Google domain to use (e.g. google.com, google.fr).
Default
"google.com"async?boolean
If true, returns a job and lets you fetch results asynchronously.
Default
"false"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.autom.dev/v1/google/images" \ -H "Content-Type: application/json" \ -d '{ "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"
}
}{
"error": "Bad Request"
}{
"error": "Invalid API Key"
}{
"error": "Payment required"
}{
"error": "Rate limit exceeded for the API key: quota monthly"
}{
"error": "Internal Error"
}