Search Google organic results

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

Returns Google's organic results for a query, with related questions and searches. Use it to check rankings on Google.

Tool google.serp.organic 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".

devicestring· default desktop

desktop

mobile

tablet

pageinteger· default 1

Page of results, 10 per page.

At least 1.

time_rangestring

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

hour

day

week

month

year

autocorrectboolean· default true

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.

positionintegerRequired

Rank among organic results, starting at 1.

titlestringRequired

urlstringRequired

snippetstring

displayed_urlstring

The address as Google shows it under the title.

`related_questions`

A list of rows. Can be null.

questionstringRequired

`related_searches`

A list of rows. Can be null.

querystringRequired

curl https://api.voxoria.ai/v1/tools/google.serp.organic/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"query":"crm for small teams","country":"gb"}}'

import os

import httpx

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

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

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.serp.organic",
    "input": {
      "query": "crm for small teams",
      "country": "gb"
    }
  }
}

200 OKoutputapplication/json

{
  "results": [
    {
      "position": 1,
      "title": "5 best CRMs for small teams (and how to choose the right ...",
      "url": "https://www.insightly.com/blog/top-crms-for-small-teams/",
      "snippet": "Insightly is a modern, affordable CRM that small teams love because it's easy to use, you can customize it to your needs, and it scales with you as you grow. Read more",
      "displayed_url": "https://www.insightly.com › blog › top-crms-for-small-t..."
    },
    {
      "position": 2,
      "title": "Best CRM software for small businesses (2026)",
      "url": "https://www.enterprisenation.com/learn-something/best-crm-software-small-businesses/",
      "snippet": "22 Dec 2025 — Comprehensive set of features: HubSpot CRM lets you manage your contacts and track leads with ease. You can also integrate your email marketing. Read more",
      "displayed_url": "https://www.enterprisenation.com › learn-something › b..."
    },
    {
      "position": 3,
      "title": "10 Shortlist UK's CRM Software for Small Business (2026)",
      "url": "https://www.dynamicssquare.co.uk/blog/best-crm-software-for-small-business/",
      "snippet": "12 Jul 2025 — CRM software provides teams with access to customer information, communication history, preferences, opportunities, and previous interactions. Read more",
      "displayed_url": "https://www.dynamicssquare.co.uk › blog › best-crm-sof..."
    }
  ],
  "related_questions": [],
  "related_searches": [
    {
      "query": "Best crm for small teams"
    },
    {
      "query": "Best CRM for small business free"
    },
    {
      "query": "Best CRM for small business reddit"
    }
  ]
}

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