Tracking Keywords
Overview
Tracked keywords are the backbone of ongoing SEO monitoring. Add the terms that matter to your client's business, then pull ranking history to spot trends, drops, or wins over time.
list-tracked-keywords
Returns all keywords currently tracked for a site, including their latest ranking position and the location they're tracked in.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site to list tracked keywords for |
Example
"Show me all the keywords I'm tracking for site 1."
add-tracked-keyword
Adds a new keyword to your tracking list. Rankings will be checked on your plan's sync schedule (daily for Pro/Agency, weekly for Starter).
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site to track the keyword for |
keyword | string | Yes | The keyword to start tracking |
location_code | integer | No | Location code for geo-targeted tracking (use reference tools to find codes) |
language_code | string | No | Language code (e.g., "en") |
Example
"Start tracking 'pool installation maryland' for site 1."
Tips
- Your plan has a keyword limit (50 for Starter, 250 for Pro, 1,000 for Agency). Check
list-tracked-keywordsto see how many slots you've used. - Track both branded and non-branded terms to get the full picture of organic visibility.
remove-tracked-keyword
Removes a keyword from tracking. Historical data is retained but no new rankings will be collected. Takes a single tracked_keyword_id (integer, required) from list-tracked-keywords.
"Stop tracking keyword 42."
get-keyword-ranking-history
Pulls the ranking position history for a tracked keyword over time. Use this to visualize trends, confirm the impact of optimizations, or catch ranking drops early.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tracked_keyword_id | integer | Yes | The tracked keyword ID |
days | integer | No | Number of days of history (1–365, default 30) |
Example
"Show me the ranking history for keyword 12 over the last 90 days."
Tips
- Compare ranking history before and after content updates to measure impact.
- Use the workflow:
list-tracked-keywords→ pick keyword IDs →get-keyword-ranking-historyfor each.