Find keyword ideas related to a seed keyword

POST/v1/tools/google.keywords.ideas/callsNeeds an API key

Returns keywords related to a seed keyword, with search volume, CPC, competition and difficulty. Use it to find new keywords to target.

Tool google.keywords.ideas 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

keywordstringRequired

The seed keyword to find related keywords for.

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.

pageinteger· default 1

Page of results, 10 per page.

At least 1.

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.

keywordstringRequired

search_volumeinteger

Average monthly Google searches in the country.

monthly_searchesarray of object

Google searches in the country in each recent month, usually the last 12.

monthly_searches.yearintegerRequired

monthly_searches.monthintegerRequired

Month of the year, from 1 (January) to 12.

monthly_searches.search_volumeintegerRequired

cpcnumber

Average cost per click in Google Ads, in USD.

competitionnumber

Advertiser competition for the keyword in Google Ads, from 0 (none) to 1 (highest).

competition_levelstring

The same competition as a band.

low

medium

high

keyword_difficultyinteger

How hard it is to rank in the top 10 organic results, from 0 (easiest) to 100.

search_intentstring

What the searcher wants.

informational

navigational

commercial

transactional

curl https://api.voxoria.ai/v1/tools/google.keywords.ideas/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"keyword":"crm software","country":"gb"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/google.keywords.ideas/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={"input": {"keyword": "crm software", "country": "gb"}},
    timeout=60,
)
print(response.json())

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

{
  "name": "call_tool",
  "arguments": {
    "tool": "google.keywords.ideas",
    "input": {
      "keyword": "crm software",
      "country": "gb"
    }
  }
}

200 OKoutputapplication/json

{
  "results": [
    {
      "keyword": "crm meaning",
      "search_volume": 18100,
      "monthly_searches": [
        {
          "year": 2026,
          "month": 9,
          "search_volume": 18100
        },
        {
          "year": 2026,
          "month": 8,
          "search_volume": 18100
        },
        {
          "year": 2026,
          "month": 7,
          "search_volume": 18100
        }
      ],
      "cpc": 7.9,
      "competition": 0.09,
      "competition_level": "low",
      "keyword_difficulty": 35,
      "search_intent": "informational"
    },
    {
      "keyword": "zoho crm",
      "search_volume": 14800,
      "monthly_searches": [
        {
          "year": 2026,
          "month": 9,
          "search_volume": 18100
        },
        {
          "year": 2026,
          "month": 8,
          "search_volume": 14800
        },
        {
          "year": 2026,
          "month": 7,
          "search_volume": 14800
        }
      ],
      "cpc": 9.08,
      "competition": 0.4,
      "competition_level": "medium",
      "keyword_difficulty": 33,
      "search_intent": "navigational"
    },
    {
      "keyword": "crm software",
      "search_volume": 8100,
      "monthly_searches": [
        {
          "year": 2026,
          "month": 9,
          "search_volume": 18100
        },
        {
          "year": 2026,
          "month": 8,
          "search_volume": 14800
        },
        {
          "year": 2026,
          "month": 7,
          "search_volume": 9900
        }
      ],
      "cpc": 22.73,
      "competition": 0.29,
      "competition_level": "low",
      "keyword_difficulty": 50,
      "search_intent": "commercial"
    }
  ]
}

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