SERP
Google Images
Google Image search results — thumbnails, source URLs, titles, and image metadata.
POST
$0.01/call/v1/serp/google-imagesUsage
const res = await fetch('https://api.yepapi.com/v1/serp/google-images', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ query: 'modern dashboard UI design', depth: 10 }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/serp/google-images \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "modern dashboard UI design", "depth": 10}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | Image search query to look up on Google Images | — |
depth | number | No | Number of results to return | 10 |
location_code | number | No | Target country code (e.g., 2840 for US). See Location Codes. | 2840 |
language | string | No | ISO language code (e.g., en, es) | "en" |
Response
{
"ok": true,
"data": {
"query": "modern dashboard UI",
"totalResults": 0,
"results": [
{
"position": 2,
"type": "imagesSearch",
"title": "Modern Dashboard Design designs, themes ...",
"url": "https://dribbble.com/tags/modern-dashboard-design",
"description": "",
"domain": ""
},
{
"position": 3,
"type": "imagesSearch",
"title": "Modern Dashboard UI Design Design ...",
"url": "https://www.figma.com/community/file/1339194361793974200/modern-dashboard-ui-design-design-free",
"description": "",
"domain": ""
},
{
"position": 4,
"type": "imagesSearch",
"title": "Dashboard Design: best practices and ...",
"url": "https://www.justinmind.com/ui-design/dashboard-design-best-practices-ux",
"description": "",
"domain": ""
}
]
}
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.query | string | The image search query that was executed |
data.totalResults | number | Total number of image results found (may be 0 when Google does not expose a count) |
data.results | object[] | Array of image search result items |
data.results[].position | number | Position in image search results (1-indexed) |
data.results[].type | string | Result type (e.g., imagesSearch, carousel, relatedSearches) |
data.results[].title | string | Title or alt text of the image result |
data.results[].url | string | URL of the page containing the image |
data.results[].description | string | Description or caption of the image (often empty for image results) |
data.results[].domain | string | Domain of the source page (may be empty for image results) |
Under the Hood
Under the hood, this queries our SERP engine. We normalize the response format and flatten nested structures for consistency.