Add rank tracking keywords
add_rank_tracking_keywordsAdd keywords to an existing rank tracker. This buys nothing and starts no check. On a scheduled tracker first show the user the price from estimate_rank_tracker_cost and pass that figure as maxEstimatedScheduledCheckCredits. A scheduled tracker buys its checks only under the user's approval of its settings, given on the tracker's page: without one its schedule is paused, buying nothing, until they approve there (scheduleAwaitsApproval). Keywords already tracked and repeats are skipped; added is the number really added.
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": {
"projectId": "<projectId>",
"trackerId": "<trackerId>",
"keywords": "<keywords>"
},
"name": "add_rank_tracking_keywords"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keywords | Yes | Keywords to start tracking. | |
| matchCase | No | Track keywords exactly as typed instead of lowercasing them. A keyword with capitals is tracked and billed separately from its lowercase form. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| trackerId | Yes | Tracker id from get_rank_tracker. | |
| maxEstimatedScheduledCheckCredits | No | Needed for a scheduled tracker: the scheduled figure estimate_rank_tracker_cost returns as costCredits, passed once the user has seen that recurring price. The keywords are refused when a check would cost more. It does not approve the schedule: the user does that on the tracker's page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| added | Yes | ||
| addedIds | Yes | ||
| requested | Yes | ||
| trackerId | Yes | ||
| scheduledEstimate | No |