Search Google Images

POST/v1/tools/google.serp.images/callsNeeds an API key

Returns Google Images results for a query, with image URLs, sizes and source pages. Use it to see which images rank for a search.

Tool google.serp.images on Google. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

querystringRequired

The search query.

countrystring· default us

Two-letter ISO 3166-1 country code. Case-insensitive.

One of the 249 values of the countries list: ISO 3166-1 alpha-2 country codes, lowercase.

languagestring· default en

Two-letter ISO 639-1 language code. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

locationstring

Google location name, such as "New York, New York, United States".

pageinteger· default 1

Page of results.

At least 1.

time_rangestring

Only images from the last hour, day, week, month or year.

hour

day

week

month

year

autocorrectboolean

Whether Google may correct the spelling of the query.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`results`

A list of rows. Always present, possibly empty.

positioninteger

Rank among image results, starting at 1.

titlestring

urlstringRequired

Address of the page the image is on.

image_urlstringRequired

Address of the image itself, at full size.

image_widthinteger

Width of the image, in pixels.

image_heightinteger

Height of the image, in pixels.

thumbnail_urlstring

Address of Google's reduced copy of the image.

sourcestring

Name of the site the image is on.

curl https://api.voxoria.ai/v1/tools/google.serp.images/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"mid-century armchair","country":"gb"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.serp.images/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {"query": "mid-century armchair", "country": "gb"},
    },
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/google.serp.images/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {"query": "mid-century armchair", "country": "gb"},
  }),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.serp.images",
    "input": {
      "query": "mid-century armchair",
      "country": "gb"
    }
  }
}

200 OKoutputapplication/json

{
  "results": [
    {
      "position": 1,
      "title": "Mid-Century Armchairs, Set of 2",
      "url": "https://www.pamono.co.uk/mid-century-armchairs-set-of-2-108?srsltid=AU7gw4VZ9V9O8VGMzOTg0j9HW42BpN5RzzXZyycZ0jSYFWvn8M6Pfg6t",
      "image_url": "https://cdn20.pamono.com/p/g/2/2/2208117_ar9ptk8epq/mid-century-armchairs-set-of-2-image-1.jpg",
      "image_width": 710,
      "image_height": 400,
      "thumbnail_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTC5mgV2ZoTThpksd5iLk1uzxyNxZMGsdPSfwDVx3dHFA&s=10",
      "source": "Pamono"
    },
    {
      "position": 2,
      "title": "Esmeray Beige Fabric Mid Century Modern Accent Chair",
      "url": "https://furniturebox.co.uk/products/esmeray-beige-fabric-mid-century-modern-accent-chair",
      "image_url": "https://furniturebox.co.uk/cdn/shop/files/Esmeray-cream-fabric-accent-chair_1_d7913753-e6d9-46a0-9444-62936c807a77.jpg?v=1784746658",
      "image_width": 2200,
      "image_height": 2200,
      "thumbnail_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcScYNifyQgvSTguqaeU4u-st7aDDRSg9em8j3YGIQjvsw&s=10",
      "source": "Furniturebox"
    },
    {
      "position": 3,
      "title": "Jeni Textured Boucle Mid Century Armchair",
      "url": "https://www.laredoute.co.uk/ppdp/prod-350336118.aspx",
      "image_url": "https://cdn.laredoute.com/products/8/8/7/887314c6f8b93171d2af30a9a90379e7.jpg",
      "image_width": 1200,
      "image_height": 1200,
      "thumbnail_url": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcQzssi2vOOL3aHIOUeVRujU9Ige6NHLtAhYk2hJFAvqyA&s=10",
      "source": "La Redoute"
    }
  ]
}

The output of a real call, each list cut to 3 items.