get_alerts

Get price alert list

Query

Description

Get price alert list, view all price drop alerts pushed by the system. Supports unread filtering and site filtering.

Typical user queries:

• "Are there any new price drop alerts"
• "Which products have dropped in price recently"
• "How many unread alerts are there"
• "Which product was the last pushed price drop alert for"

Optional parameters:

• unread_only: Return only unread alerts (default false)
• site: Filter by site
• limit: Maximum number of results (default 10, max 50)

Parameters

Parameter	Type	Required	Default	Description
unread_only	boolean	No	false	Return only unread alerts
site	string	No	null	Site filter
limit	integer	No	10	Number of results (max 50)

Returns

Returns alert list text, including product name, shop, site, price change percentage, and alert time.

3 alerts in total (1 unread):

- 📩 [1] iPhone 15 Pro Max | Apple Official Store (SG)
  SGD 1599 → 1499 (↓6.3%) | 2026-06-23 08:05
- ✓ [2] AirPods Pro 2 | Apple Official Store (SG)
  SGD 349 → 329 (↓5.7%) | 2026-06-22 14:10
- ✓ [3] Samsung S24 Ultra | Samsung Store (MY)
  MYR 3999 → 3599 (↓10.0%) | 2026-06-21 08:15

Conversation Examples

• "Are there any new price drop alerts"
• "How many unread alerts are there"
• "Which product was the last pushed price drop alert for"

API Endpoint

GET /alerts