get_price_history

Get time-series price data for a specified product

Query

Description

Get time-series price data for a specified product, which can be used to draw price trend charts or analyze price changes.

Typical user queries:

• "Show me the price trend of this product over the past 7 days"
• "Price change records for the iPhone product"
• "Help me draw a price line chart"
• "What are the prices of the competitors I'm monitoring on the MY site today, show me the trends"

Requires monitor_id (required). Optional days parameter (default 7, max 90).

Parameters

Parameter	Type	Required	Default	Description
monitor_id	integer	Yes	—	Monitor ID
days	integer	No	7	Number of days (max 90)

Returns

Returns price history data and trend analysis in Markdown table format.

iPhone 15 Pro Max price history for the past 7 days (SGD, 7 records):

| Crawl Time | Price | Original Price | Discount Rate |
|------------|-------|----------------|---------------|
| 2026-06-22 08:00 | 1599 | 1599 | — |
| 2026-06-22 14:00 | 1599 | 1599 | — |
| 2026-06-23 08:00 | 1499 | 1799 | 16.8% |
| 2026-06-23 14:00 | 1499 | 1799 | 16.8% |

Trend analysis: Dropped from SGD 1599 to SGD 1499 (↓6.3%), competitor may be running a price promotion.

Conversation Examples

• "Show me the price trend of this product over the past 7 days"
• "Price change records for the iPhone product"
• "Help me draw a price line chart"

API Endpoint

GET /price/history