Get a monitor's history
monitoring_get_historyOne monitor's checks over time: its main number each check, the breakdown and what each check cost.
Use when: "is our AI visibility going up", "how many new threads a week", "show the trend", or to explain a change against earlier checks. Not for: the individual changes, use monitoring_get_changes. The list of monitors, use monitoring_get_monitors. Returns: List, newest first. rows[]: check_id, checked_at, status (done or failed), baseline (the first check, a starting point), headline, series (ai_visibility: the brand's share per engine, all (the mean of the engines), margin (its 95% margin), cited and cited: (answers linking the brand's site), sov (share of voice), branded (share on prompts that name the brand), answered: (prompts the engine answered), and brand: per competitor; mentions: new posts per platform; website_changes: changes per site; google_rankings: ranked, top10 and kw: positions), warnings (where the check read less than it should; an empty search is not one), changes, credits, error. Cost: 0 credits. Example: {"monitor_id": "trk_01J..."}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Checks, newest first. | |
| monitor_id | Yes | From monitoring_get_monitors. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| meta | Yes | ||
| rows | No | ||
| error | No | ||
| hints | Yes |