list-alertsfreeStored Metrics & ReportingList Alerts Tool
List operator alerts (rank drops, sync failures, lost backlinks, AI-mention drops, audit health) for the team's tracked sites. Defaults to active (unacknowledged + unexpired) alerts in the last 7 days. Use this to answer "what needs attention on this client/portfolio right now?". Pair with acknowledge-alert to mark items as handled.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| site_id | integer | optional | Optional. Limit alerts to a specific tracked site. |
| state | string | optional | Filter by state. 'active' (default) = unacknowledged + unexpired. 'acknowledged' = touched by a teammate. 'all' = both. |
| kinds | array | optional | Optional alert kinds to include. One or more of: 'rank_drop', 'backlinks_lost', 'sync_failed', 'llm_mentions_dropped', 'audit_health_low'. |
| severities | array | optional | Optional severities to include. One or more of: 'info', 'warn', 'critical'. |
| since_hours | integer | optional | Lookback window in hours. Default 168 (7 days). Max 720 (30 days). |
| limit | integer | optional | Maximum rows to return. Default 50, max 200. |
Plan access
Available on the free tier and above. Live tools draw from your team's monthly credit budget at parity with upstream API cost (1 credit ≈ $0.001).
See plans