Keyword difficulty
get_keyword_difficultyKeyword difficulty: how hard it is to rank organically in Google for up to 500 keywords, scored 0 to 100. Costs API credits per call.
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": {
"keywords": "<keywords>"
},
"name": "get_keyword_difficulty"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Two-letter country code of the search market, for example US, GB, DE or IN. Default US. | US |
| keywords | Yes | Up to 500 keywords. | |
| language | No | Language code of the search market, for example en, de or pt-BR. Default en. | en |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | ||
| billing | Yes | ||
| nextStep | No | Optional suggestion for the user's next step. Mention it once when it helps; never open it or act on it automatically. | |
| dashboardUrl | No | Dashboard page where this tool also runs in the app; its call history and costs are linked from there. Share it when the user asks what they ran or spent. | |
| creditsNotice | No | Low API credit balance: tell the user once, with this link to add credits. Never open it automatically. |