Get alert settings
Read a website's rank-change alert configuration, whether the weekly email is on, its threshold and recipient.
https://api.rankparse.com/v1/rank-tracking/alert-settingsFreeAPI keyReturns the rank-change alert settings of one website. Alerts are opt-in and off by default. A website that was never configured returns the defaults. Change them with Update alert settings.
Query parameters
site_idstringrequiredThe website, from List sites. A missing or unknown ID returns 404 rank_tracking_site_not_found.
Response
site_idstringThe website you asked for.
enabledbooleanWhether daily detection and the weekly email are on for this website. Default false.
email_overridestring | nullAddress that receives this website's lines instead of the account email. null uses the account email.
move_thresholdnumberAverage-position change that records a moved_up or moved_down event. Default 5.
min_clicksintegerKeywords with fewer clicks than this, over the 28 days ending on their latest synced day, raise no alerts. 0 (the default) keeps every keyword. A search engine that reports no clicks counts as zero.
last_detected_datestring | nullThe last UTC date detection ran for this website, or null if it never has.
Errors
| HTTP | Code | When |
|---|---|---|
| 401 | invalid_api_key | Missing, invalid or revoked API key. |
| 404 | rank_tracking_site_not_found | No website with that site_id in your workspace. |
| 429 | rate_limited | More than 60 requests per minute for this key. |
Related
MCP tool: get_rank_alert_settings (accepts site_id).