Price Monitor

Price Monitor tracks your products' prices across internal sources and competitor sites, giving you full visibility over pricing and margins.

GET/prices/products/{id}

Get product prices

Returns all price entries (internal and competitor) associated with a product.

Path parameters

Name
id
Type
string
Description
The product UUID.

Request

GET

/prices/products/{id}

curl https://api.pixeepim.com/api/v1/prices/products/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer {api_key}"

Response

{
  "product_id": "550e8400-e29b-41d4-a716-446655440000",
  "product_name": "Produit exemple",
  "prices": [
    {
      "id": "550e8400-e29b-41d4-a716-000000000001",
      "source": "internal",
      "source_name": "Ma boutique",
      "price_type": "retail",
      "price": 29.99,
      "cost": 18.00,
      "margin": 40.0,
      "currency": "EUR",
      "is_active": true,
      "valid_from": "2026-01-01T00:00:00Z",
      "valid_until": null
    },
    {
      "id": "550e8400-e29b-41d4-a716-000000000002",
      "source": "amazon_fr",
      "source_name": "Amazon France",
      "price_type": "competitor",
      "price": 27.50,
      "currency": "EUR",
      "is_active": true,
      "url": "https://amazon.fr/dp/B0123456789",
      "valid_from": "2026-05-10T00:00:00Z"
    }
  ],
  "internal_price": 29.99,
  "best_competitor_price": 27.50
}

POST/prices/products/{id}/competitor-prices

Add a competitor price

Manually records a competitor price for a product.

Path parameters

Name
id
Type
string
Description
The product UUID.

Body parameters

Name
source
Type
string
Description
Source identifier (e.g. amazon_fr, fnac, cdiscount).
Name
price
Type
number
Description
Competitor price.
Name
currency
Type
string
Description
ISO 4217 currency code (default: EUR).
Name
url
Type
string
Description
Direct URL to the product on the competitor's site (HTTPS required).
Name
valid_until
Type
string
Description
ISO 8601 expiry datetime.
Name
notes
Type
string
Description
Optional free-text notes (e.g. "Promotion -10%").

Request

POST

/prices/products/{id}/competitor-prices

curl -X POST https://api.pixeepim.com/api/v1/prices/products/550e8400-e29b-41d4-a716-446655440000/competitor-prices \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "amazon_fr",
    "price": 27.50,
    "currency": "EUR",
    "url": "https://amazon.fr/dp/B0123456789",
    "notes": "Prix observé le 14 mai 2026"
  }'

Response

{
  "id": "550e8400-e29b-41d4-a716-000000000003",
  "source": "amazon_fr",
  "price": 27.50,
  "currency": "EUR",
  "is_active": true,
  "created_at": "2026-05-14T10:30:00Z"
}

PATCH/prices/{price_id}

Update a price

Updates an existing price entry.

Path parameters

Name
price_id
Type
string
Description
The price entry UUID.

Body parameters

Name
price
Type
number
Description
Updated price value.
Name
is_active
Type
boolean
Description
Enable or disable this price entry.
Name
valid_until
Type
string
Description
Updated expiry datetime.

Request

PATCH

/prices/{price_id}

curl -X PATCH https://api.pixeepim.com/api/v1/prices/550e8400-e29b-41d4-a716-000000000002 \
  -H "Authorization: Bearer {api_key}" \
  -H "Content-Type: application/json" \
  -d '{"price": 26.99, "is_active": true}'

Response

{
  "id": "550e8400-e29b-41d4-a716-000000000002",
  "price": 26.99,
  "is_active": true,
  "updated_at": "2026-05-14T11:00:00Z"
}

GET/prices/products/{id}/history

Get price history

Returns the price history for a product across all sources.

Path parameters

Name
id
Type
string
Description
The product UUID.

Query parameters

Name
date_from
Type
string
Description
ISO 8601 start datetime.
Name
date_to
Type
string
Description
ISO 8601 end datetime.
Name
skip
Type
integer
Description
Offset (default: 0).
Name
limit
Type
integer
Description
Items per page, max 200 (default: 50).

Request

GET

/prices/products/{id}/history

curl "https://api.pixeepim.com/api/v1/prices/products/550e8400-e29b-41d4-a716-446655440000/history?date_from=2026-01-01T00:00:00Z" \
  -H "Authorization: Bearer {api_key}"

Response

{
  "product_id": "550e8400-e29b-41d4-a716-446655440000",
  "product_name": "Produit exemple",
  "history": [
    {
      "date": "2026-05-14T00:00:00Z",
      "price": 29.99,
      "source": "internal",
      "source_name": "Ma boutique",
      "cost_price": 18.00,
      "currency": "EUR"
    },
    {
      "date": "2026-05-10T00:00:00Z",
      "price": 27.50,
      "source": "amazon_fr",
      "currency": "EUR"
    }
  ],
  "total_entries": 48
}

GET/prices/products/{id}/stats

Get price stats

Returns aggregated price statistics for a product across all sources.

Path parameters

Name
id
Type
string
Description
The product UUID.

Request

GET

/prices/products/{id}/stats

curl https://api.pixeepim.com/api/v1/prices/products/550e8400-e29b-41d4-a716-446655440000/stats \
  -H "Authorization: Bearer {api_key}"

Response

{
  "product_id": "550e8400-e29b-41d4-a716-446655440000",
  "current_price": 29.99,
  "lowest_price": 24.99,
  "highest_price": 34.99,
  "average_price": 29.50,
  "price_trend": "stable",
  "price_change_pct": -2.5,
  "sources_count": 3,
  "sources": ["internal", "amazon_fr", "fnac"],
  "last_updated": "2026-05-14T10:30:00Z"
}

GET/prices/products/{id}/best-price

Get best price

Returns the lowest active price across all sources for a product.

Path parameters

Name
id
Type
string
Description
The product UUID.

Request

GET

/prices/products/{id}/best-price

curl https://api.pixeepim.com/api/v1/prices/products/550e8400-e29b-41d4-a716-446655440000/best-price \
  -H "Authorization: Bearer {api_key}"

Response

{
  "product_id": "550e8400-e29b-41d4-a716-446655440000",
  "best_price": 27.50,
  "source": "amazon_fr",
  "source_name": "Amazon France",
  "url": "https://amazon.fr/dp/B0123456789",
  "valid_until": null
}