Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.neariq.io/llms.txt

Use this file to discover all available pages before exploring further.

What triggers an alert?

NearIQ generates alerts when it detects a meaningful change in competitor data. Alerts are classified by type and severity.

Alert types

Alert typeWhat it means
rating_dropA competitor’s rating decreased by ≥ 0.1 stars
rating_riseA competitor’s rating increased — they may be recovering
review_surgeA competitor received significantly more reviews than usual
competitor_response_dropA competitor’s owner response rate dropped by more than 15 points
competitor_negative_surgeA competitor received 3+ low-star reviews in one week
trend_opportunityA rising trend keyword is missing from your own reviews
competitor_rating_windowA competitor’s rating fell below yours for the first time
own_rating_dropYour rating dropped — high priority
own_review_surgeYour business got a surge of reviews (positive or negative)
hours_changeA competitor updated their business hours
website_changeA competitor changed their website URL
local_pack_changeA competitor entered or exited the top-3 local pack for a tracked keyword
velocity_spikeReview velocity spiked abnormally — potential review campaign or review attack
new_competitorA new business appeared in your tracked area

Severity levels

SeverityDescription
infoLow-signal change, informational only
warningNotable change worth monitoring
opportunityA competitor is struggling — potential customer acquisition window
dangerRequires immediate attention (your rating dropped, review attack, etc.)

Configuring alerts

Go to AlertsSettings to configure:
  • Enabled alert types — toggle specific alert types on/off
  • Minimum severity — filter alerts below a threshold (e.g. only warning and above)
  • Delivery channels — email digest, real-time email, webhook, or in-app only

Email digest

The daily digest is a summary of all alerts from the past 24 hours, delivered at your configured time in your local timezone. You can configure:
  • Delivery time (default: 8:00 AM)
  • Day-of-week filter (e.g. weekdays only)
  • Minimum severity for digest inclusion

Webhooks

Alerts can also be delivered to a webhook endpoint in real-time. See Webhooks for payload format and signature verification.