Price Monitor

Price Monitor tracks your products' prices across competitor sites and marketplaces, and triggers alerts when prices change.


GET/price-monitor/products

List tracked products

Returns all products currently being monitored.

Request

GET
/price-monitor/products
curl https://api.productsmanager.app/api/v1/price-monitor/products \
  -H "Authorization: Bearer {api_key}"

Response

{
  "data": [
    {
      "ean": "3760000000001",
      "title": "Produit exemple",
      "your_price": 29.99,
      "lowest_competitor_price": 27.50,
      "competitor_count": 4,
      "last_checked_at": "2024-03-15T06:00:00Z"
    }
  ]
}

POST/price-monitor/products

Add a product to tracking

Adds a product to the price monitoring watchlist.

Body parameters

  • Name
    ean
    Type
    string
    Description

    The product EAN to monitor.

  • Name
    alert_threshold_percent
    Type
    number
    Description

    Send an alert when a competitor's price is this % below your price. Default: 5.

Request

POST
/price-monitor/products
curl -X POST https://api.productsmanager.app/api/v1/price-monitor/products \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{"ean": "3760000000001", "alert_threshold_percent": 10}'

Response

{
  "ean": "3760000000001",
  "status": "tracking",
  "alert_threshold_percent": 10,
  "created_at": "2024-03-15T09:00:00Z"
}

GET/price-monitor/products/{ean}/history

Get price history

Returns the price history for a tracked product.

Path parameters

  • Name
    ean
    Type
    string
    Description

    The product EAN.

Query parameters

  • Name
    days
    Type
    integer
    Description

    Number of days of history to return (default: 30, max: 365).

Request

GET
/price-monitor/products/{ean}/history
curl "https://api.productsmanager.app/api/v1/price-monitor/products/3760000000001/history?days=30" \
  -H "Authorization: Bearer {api_key}"

Response

{
  "ean": "3760000000001",
  "data": [
    {
      "date": "2024-03-15",
      "your_price": 29.99,
      "competitor_prices": [
        {"retailer": "Amazon", "price": 28.50},
        {"retailer": "Fnac", "price": 30.00}
      ]
    }
  ]
}

Was this page helpful?