Related keywords (up to 100, depth 0-4)
related_keywordsRelated keywords for a seed from Google's 'searches related to' graph, to a depth of 0-4, each with search volume, CPC, competition, keyword difficulty and search intent; up to 100 in one $0.04 call (Google Ads data). Use when you need topic clusters around a keyword. Each row has its depth and the further related searches. No matches returns empty results (still charged). Bad input is free; upstream errors are not charged. Price: $0.04 per successful call, paid over x402 (USDC on Base); pass the payment in _meta["x402/payment"].
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"keyword": "<keyword>"
},
"name": "related_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| depth | No | How many levels of the related-searches graph to traverse (0-4). Defaults to 1. | |
| limit | No | Maximum keywords to return (1-100). Defaults to 20. | |
| country | No | Optional ISO 3166-1 alpha-2 code or country name, used when locationCode is absent (uk = gb). | |
| keyword | Yes | Seed keyword (at most 80 characters; whitespace, control characters and case are normalised; a seed then empty, over 10 words or over 80 characters is a free 400). | |
| languageCode | No | Language code (2-letter). Defaults to en. An unsupported location falls back to 2840 (United States) with en (or the requested language if the United States offers it); a supported location with a language it does not offer uses that location's default language (en if offered). Either way market.fallback is true and market.warnings says what was used. | |
| locationCode | No | Google Ads location code (geo target ID). Defaults to 2840 (United States); an unsupported code falls back to 2840 (United States, market.fallback). |