Skip to content

get_price_summary

Get price summary for a specified product or all active monitored products

Query

Description

Get price summary for a specified product or all active monitored products, including current price, baseline price, highest/lowest/average price, and trend direction.

Typical user queries:

  • "How are competitor prices recently"
  • "How are the prices of the products I'm monitoring on the SG site over the past 2 days"
  • "Are there any competitors with price drops"

If monitor_id is not specified, returns summaries for all active monitors. Optional site filter and days parameter (default 3).

Parameters

ParameterTypeRequiredDefaultDescription
monitor_idintegerNonullSpecify Product ID (single product mode)
sitestringNonullSite filter (sg/my/th/vn)
daysintegerNo3Statistics days

Returns

Returns price summary text, including current price, baseline price, highest/lowest/average price, trend direction, and crawl count.

Price summary for the past 3 days (3 products total):

- [1] iPhone 15 Pro Max (SG)
  Current SGD 1499 | Baseline SGD 1599 | Highest SGD 1599 | Lowest SGD 1499 | Average SGD 1549 | Trend 📉 Down | 12 crawls
- [2] AirPods Pro 2 (SG)
  Current SGD 349 | Baseline SGD 349 | Highest SGD 349 | Lowest SGD 329 | Average SGD 339 | Trend ➡️ Stable | 12 crawls

Conversation Examples

  • "How are competitor prices recently"
  • "How are the prices of the products I'm monitoring on the SG site over the past 2 days"
  • "Are there any competitors with price drops"

API Endpoint

GET /price/summary

Released under the MIT License.