Skip to content
Docs

Build on the price graph

Everything the shop uses is available through the same public API — lookups, history, forecasts, webhooks and auto-buy.

Product lookup — cURL
curl https://api.pricepilot.ai/v1/products/lookup \
  -H "Authorization: Bearer $PRICEPILOT_KEY" \
  -G --data-urlencode "url=https://retailer.example/p/aurora-anc"

{
  "id": "prod_9Yz2",
  "name": "Aurora ANC Over-Ear Headphones",
  "price": { "amount": 289, "currency": "USD", "normalised": true },
  "forecast": { "p10": 251, "p50": 264, "p90": 289, "horizon_days": 30 }
}

Getting started

Quickstart

Create an account, install the browser companion and track your first product in under two minutes. Everything below assumes you already have an API key from the dashboard.

Authentication

All requests use a bearer token in the Authorization header. Keys are scoped per environment and can be rotated without downtime — old keys stay valid for one hour after rotation.

Core API

Products

Look up any tracked product by GTIN, retailer URL or PricePilot ID. Responses include the normalised price, the full history series and the current forecast when one is available.

Price history

Returns up to 24 months of hourly-sampled pricing, downsampled to daily by default. Pass resolution=hourly for the raw series, capped at 90 days per request.

Forecasts

Returns the 10th, 50th and 90th percentile predicted price for the next 30 days. Suppressed forecasts return null with a reason code rather than an estimate.

Automation

Webhooks

Subscribe to price.dropped, price.forecast_updated, product.restocked and order.status_changed. Every delivery is signed and retried with exponential backoff for 24 hours.

Auto-buy

Create a purchase intent with a target price and a hard spending cap. When the target is met we complete checkout using a single-use virtual card scoped to that intent.

Need something the API doesn't cover?

Tell us what you're building. We ship endpoints requested by developers far more often than ones we invent ourselves.

  • 200+ Retailers tracked
  • Cancel anytime
  • No credit card required