API
Google Images API
Image results with the source page, original image URL and size, and thumbnail.
What you get
- position
- title
- source page
- original image URL
- width and height
- thumbnail
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| query | string | Yes | Search term. |
| country | string | No | 2-letter country code, one of: us, gb, uk, ca, au, de, fr, nl, it, es, pt, be, at, ch, se, no, dk, fi, ie, pl, cz, il, ae, in, jp, kr, sg, mx, br, nz, za, tr ("uk" = "gb"). Default "us". |
| language | string | No | 2-letter language code. Default "en". |
| page | integer | No | Only 1 is supported (Google loads more of these results by scrolling, not by page). Default 1. |
Example
curl -X POST https://api.crawlerdata.com/v1/jobs \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"endpoint":"google-images","params":{"query":"golden retriever","country":"us"},"queue":"live"}'const res = await fetch('https://api.crawlerdata.com/v1/jobs', {
method: 'POST',
headers: { Authorization: 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
body: JSON.stringify({
"endpoint": "google-images",
"params": {
"query": "golden retriever",
"country": "us"
},
"queue": "live"
}),
});
const { job, result } = await res.json();import requests
res = requests.post(
"https://api.crawlerdata.com/v1/jobs",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"endpoint": "google-images",
"params": {
"query": "golden retriever",
"country": "us",
},
"queue": "live",
},
)
data = res.json(){
"search_parameters": {
"engine": "google_images",
"query": "golden retriever",
"country": "us",
"language": "en",
"page": 1
},
"images_results": [
{
"position": 1,
"title": "Golden Retriever: Pros, Cons & Diet Guide | Ollie",
"source": "Ollie Blog",
"link": "https://blog.ollie.com/breed-deets-golden-retriever/",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSe1mLcW_M8xRI0J5UcnG6soPw9kd8XQOgz7Y4sOLFZoA&s=10",
"original_width": 2560,
"original_height": 1707,
"original": "https://blog.ollie.com/wp-content/uploads/250506_Livingroom_SHOT-10_0173_FR-scaled.jpg"
},
{
"position": 2,
"title": "Golden Retriever - Wikipedia",
"source": "Wikipedia",
"link": "https://en.wikipedia.org/wiki/Golden_Retriever",
"thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTJgYaTYzWtSBflRnX7daylj48oCNevO2UO9wZWQezLBQ&s",
"original_width": 652,
"original_height": 515,
"original": "https://upload.wikimedia.org/wikipedia/commons/b/bd/Golden_Retriever_Dukedestiny01_drvd.jpg?utm_sour…"
}
]
}Long values are shortened in this example.
Pricing
1 credit per request, the same on the live, fast, regular queues. $1.00 per 1,000 requests, down to $0.30 with larger packs.
| Pack | Credits | Price per 1,000 requests |
|---|---|---|
| Starter | 50,000 | $1.00 |
| Standard | 500,000 | $0.75 |
| Scale | 2,500,000 | $0.50 |
| Ultimate | 12,500,000 | $0.30 |
Failed requests are not charged. Prices exclude sales tax/VAT. See full pricing →