Rank Alerts

Set up automated monitoring rules that notify your team the instant a keyword gains top positions, drops significantly, or experiences URL cannibalization.

How Alerts Are Evaluated

Alert rules are evaluated automatically when a check run settles. Rather than flooding your inbox with one alert per keyword, TrackSERPs batches all matching keywords into one message per rule per run.

Available Alert Conditions

Rules support the following trigger conditions:

Condition	Parameters	Description
`entered_top_n`	`n: 3 \| 10 \| 20 \| 100`	Fires when a keyword improves from outside the top N into the top N.
`left_top_n`	`n: 3 \| 10 \| 20 \| 100`	Fires when a keyword that was in the top N falls outside the top N.
`moved_by`	`direction: up \| down \| any`, `positions: integer`	Fires when a keyword's rank shifts by at least N positions since the previous check.
`not_ranked`	None	Fires when a keyword that was previously ranked in the top 100 drops completely out of the index.
`ranking_url_changed`	None	Fires when the ranking landing page for a keyword changes (useful for detecting internal keyword cannibalization).

Notification Channels

Email Recipients: Sends a formatted HTML rank movement summary directly to team members and client viewers.
Slack Incoming Webhooks: Delivers interactive Slack blocks to your designated channel. Webhook URLs are encrypted at rest with AES-256-GCM and must resolve to hooks.slack.com.
Custom Webhooks: Dispatches the alert.triggered event payload to your registered webhook endpoints.

Alert Cooldowns

Every rule specifies a cooldown window (default: 24 hours per keyword per rule). If a keyword triggers an alert, that same keyword will not trigger the same rule again until the cooldown expires, preventing notification spam on fluctuating search results.

Sample Webhook Alert Payload

alert.triggered Payload

{
  "id": "evt_alert_123",
  "type": "alert.triggered",
  "created_at": "2026-11-09T08:03:12.000Z",
  "account_id": "acc_demo123",
  "data": {
    "rule_id": "rule_top3_win",
    "rule_name": "Core keywords entered top 3",
    "project_id": "proj_abc123",
    "matches": [
      {
        "keyword_id": "kw_456",
        "phrase": "rank tracker api",
        "device": "desktop",
        "previous_rank": 5,
        "rank": 2,
        "previous_url": "example.com/features",
        "url": "example.com/api"
      }
    ]
  }
}