Find competitor keywords (keyword gap)
find_competitor_keywordsCompetitor keywords: keywords a competitor domain ranks for in Google that your domain does not, with search volume, difficulty and the competitor's position. 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": {
"competitor": "<competitor>",
"yourDomain": "<yourDomain>"
},
"name": "find_competitor_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many keywords to return, 10 to 1000. Default 100. | |
| country | No | Two-letter country code of the search market, for example US, GB, DE or IN. Default US. | US |
| language | No | Language code of the search market, for example en, de or pt-BR. Default en. | en |
| competitor | Yes | Competitor domain, for example competitor.com. | |
| yourDomain | Yes | Your domain, for example example.com. |
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. |