Product Healer API

Authentication

Every request carries a bearer token, created at /account/api. A token is shown once when you create it; we store only a hash, so it cannot be recovered.

curl -H "Authorization: Bearer ph_YOUR_TOKEN" \
     https://producthealer.tech/api/v1/tracked

Clients that cannot set an Authorization header may send X-PH-Token instead.

Rate limits

Counted per token, per minute — 60 by default, and your plan may allow more. Every reply carries the current position:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59

Going over returns 429 with a Retry-After header in seconds. Nothing is charged for a refused request.

Endpoints

How to read the numbers

Every response separates what was observed from what we estimated, and they are never merged into one field.

• observed — reported by a data provider, with observed_at saying when.
• estimate — ours, from sales rank, with a confidence and a note. It is an order of magnitude, not a forecast.
• null — we do not know. It never means zero, and you should not treat it as zero.
• Keyword positions are autocomplete positions: a demand signal, not search volume. No endpoint returns a search volume, because no source gives us one.

A worked example

$ curl -s -H "Authorization: Bearer ph_…" \
    https://producthealer.tech/api/v1/tracked

{
  "ok": true,
  "meta": { "page": 1, "limit": 50, "returned": 1 },
  "tracked": [
    {
      "asin": "B0…",
      "marketplace": "uk",
      "title": "…",
      "is_mine": true,
      "observed": {
        "price_minor": 2199, "currency": "GBP", "bsr": 2600,
        "rating": 4.4, "reviews": 344, "sellers": 9,
        "observed_at": "2026-09-22 06:10:04"
      },
      "estimate": {
        "low": 120, "high": 230, "confidence": "low", "label": "120–230",
        "caveat": "Estimated from sales rank. Not a measurement."
      },
      "since_tracking": {
        "price_minor": -300, "bsr_improved_by": 1600,
        "reviews": 26, "sellers": 3, "since": "2026-09-01 09:12:00"
      }
    }
  ]
}

Money here is in minor units — 2199 is £21.99 — so no rounding happens between us and you. Two older endpoints differ: /api/v1/products and /api/v1/suppliers return major-unit decimal strings (see their entries above). estimate is monthly units as a low–high range, never a single number, and is null when the sales rank is missing or outside the range our model covers.

MCP server (for AI assistants)

AI tools that speak the Model Context Protocol (such as Claude) can read your Product Healer data directly. Add a remote MCP server with the address https://producthealer.tech/mcp and your API token as a Bearer token (Authorization: Bearer ph_...). It uses the same token, plan check and per-minute limit as this API, is read-only, and spends no lookups: it reads what your workspace already holds.

A tool that is not in your plan is not offered. Transport: Streamable HTTP, POST only, answered with JSON (no event stream).

Errors

Every error reply is JSON with ok: false and a human-readable error. There is no error format to special-case.