Create a rank tracker
create_rank_trackerCreate a rank tracking configuration for a project. Creating an empty tracker buys nothing and starts no check. A daily, weekly or monthly tracker buys its checks once it has keywords, and only after the user approves its price on the tracker's page. The domain defaults to the project's domain; market defaults to the project's market; devices default to mobile, search depth to 40, AI Overviews to checked, and schedule to manual; re-adding an archived tracker keeps its own devices, depth and AI Overviews unless they are given, and brings back its keywords: the reply prices them, and a scheduled one stays paused, buying nothing, until the user approves that price on the tracker's page. Use estimate_rank_tracker_cost before adding keywords to a scheduled tracker or starting a live run. Call get_rank_tracker first to avoid duplicates.
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>"
},
"name": "create_rank_tracker"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | No | Domain to track. A hostname or URL is accepted and stored normalized. Defaults to the project's domain. | |
| devices | No | Devices to track. Defaults to mobile for a new tracker; a re-added archived tracker keeps its own unless this is given. | |
| projectId | Yes | Required. The Visibility Genies project this call works in and is billed to. Call list_projects to find one. | |
| serpDepth | No | Number of Google results to inspect. Defaults to 40 for a new tracker; a re-added archived tracker keeps its own unless this is given. | |
| languageCode | No | Language code such as en, es or vi. When left out, the language of the project's default market is used (see list_projects). | |
| locationCode | No | Market location code, for example 2840 for the United States. When left out, the project's default market is used (shown by list_projects and changed in project settings). A few countries, Iceland (2352) among them, only have Google Ads data: search volume, CPC and trends are available there, but keyword difficulty, search intent and domain analytics are not. | |
| locationName | No | City or region name for local rank tracking. | |
| checkAiOverviews | No | Whether each check waits for the AI Overview Google loads after the results and records whether it cites the domain. Defaults to true for a new tracker, as in the app; a re-added archived tracker keeps its own setting unless this is given. It raises each check's price, up to double at the default depth, which estimate_rank_tracker_cost includes; without it only AI Overviews already cached are seen. | |
| scheduleInterval | No | Check schedule. Defaults to manual so creating a tracker cannot cause future spend. A scheduled tracker buys nothing until it has keywords and the user approves its price on the tracker's page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | No | ||
| config | Yes | ||
| trackerId | Yes |