Skip to content

Price history

Every change of an item over time, within your plan's history.

/items/{id}/history lists everything that happened to an item, oldest first: when it appeared, every price change and other change, removals and relistings.

Shell
curl -H "Authorization: Bearer $PRICANA_KEY" https://pricana.io/api/v1/items/77/history
JSON
[
  { "id": 501, "kind": "NEW", "observedAt": "2026-09-01T10:00:00Z", "price": 1499.0, "previousPrice": null, "changes": null },
  { "id": 812, "kind": "CHANGED", "observedAt": "2026-10-06T21:03:00Z", "price": 1399.0, "previousPrice": 1499.0,
    "changes": { "price": [1499.0, 1399.0] } }
]

A price chart

The price at any time is the price of the last entry before it. For a chart, draw one step per entry:

Python
import os, requests

r = requests.get("https://pricana.io/api/v1/items/77/history",
                 headers={"Authorization": f"Bearer {os.environ['PRICANA_KEY']}"}, timeout=60)
r.raise_for_status()
points = [(e["observedAt"], e["price"]) for e in r.json() if e["price"] is not None]

observedAt is when Pricana saw the change: at most one scraping interval after it happened in the shop.

How far back

The history reaches as far back as your plan allows (7 days on Free, 90 on Starter, 365 on Pro, all on Business and Enterprise; see pricing). Older entries aren't shown. Pricana keeps item history for 365 days.

Many items

For the history of many items, the change feed is cheaper than one request per item: it lists all changes of your datasets in one stream.