Alerts

{
  "count": 1,
  "alerts": [
    {
      "id": "94d92b0e-0a92-46bb-86c3-6f8f9d3dafbf",
      "type": "rating_drop",
      "title": "Competitor rating dropped",
      "description": "A tracked competitor rating dropped.",
      "recommendation": "Watch for repeated complaints and adjust your response playbook.",
      "severity": "opportunity",
      "competitorId": "comp_xyz",
      "competitorName": "Rival Pizza",
      "createdAt": "2026-04-27T08:14:22Z",
      "read": false
    }
  ]
}

curl -X PATCH "https://app.neariq.io/api/v1/me/alerts/94d92b0e-0a92-46bb-86c3-6f8f9d3dafbf" \
  -H "X-NearIQ-Key: niq_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "read": true }'

{
  "alert": {
    "id": "94d92b0e-0a92-46bb-86c3-6f8f9d3dafbf",
    "read": true
  }
}