Stored Metrics
Overview
Stored metrics pull from data you've already synced — they don't fetch new data and don't consume credits. If a tool returns empty results, run the corresponding sync first.
get-keyword-metrics
Returns locally stored keyword metrics (volume, difficulty, CPC, intent) for your tracked keywords. Supports filtering and sorting.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site ID |
keyword | string | No | Filter by keyword (partial match) |
search_intent | string | No | informational, commercial, navigational, or transactional |
sort_by | string | No | search_volume, keyword_difficulty, cpc, or keyword |
sort_direction | string | No | asc or desc |
Example
"Show my tracked keywords sorted by search volume, highest first."
get-search-console-data
Returns Search Console data (clicks, impressions, CTR, position) with flexible date ranges and aggregation.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site ID |
start_date | string | No | Start date (YYYY-MM-DD) |
end_date | string | No | End date (YYYY-MM-DD) |
query | string | No | Filter by search query |
group_by | string | No | day, week, month, or none (default: day) |
limit | integer | No | Max results (1–500) |
offset | integer | No | Skip this many results (for paging through large lists) |
Tips
- Use
group_by: "day"for time-series charts. Usegroup_by: "none"with thequeryfilter to see per-keyword performance.
get-analytics-data
Returns Google Analytics data (sessions, users, pageviews, bounce rate) with flexible aggregation. Same parameters as get-search-console-data above (minus the query filter).
get-business-profile-data
Returns Google Business Profile performance data (search views, map views, actions). Requires GBP integration. Same parameters as get-analytics-data.
History Tools
These four tools return time-series snapshots for tracked sites. They all share the same parameters:
| Parameter | Type | Required | Description |
|---|---|---|---|
site_id | integer | Yes | The site ID |
days | integer | No | Days of history (1–365, default 90) |
- get-domain-overview-history — Organic keywords, traffic, and ranking distribution trends. Synced by
sync-domain-overview. - get-backlink-history — Backlink and referring domain snapshots over time. Synced by
sync-backlinks. - get-competitor-history — Competitor visibility and overlap snapshots. Synced by
sync-competitors. - get-llm-mention-history — AI/LLM mention frequency and sentiment over time. Synced by
sync-llm-mentions.