Skip to content

We may earn a commission from some links — it never changes our picks. How we make money →

Developers

Price-check API & MCP server

Ask HotWhatHow the question we answer for shoppers — is this actually a good price? — from your own app or an AI assistant. Free, read-only, no key needed.

What you get

For a product name, barcode (EAN/UPC) or a retailer link, the API returns our honest verdict — Good price, Average price, Consider waiting or Not enough data — with the reason, today’s lowest total price including delivery among in-stock offers at UK retailers we track, when that price was checked, how many retailers were compared, a 90-day history summary and the HotWhatHow page for the product.

  • “Lowest price” always means the lowest total landed price — never a higher-commission or sponsored offer.
  • Amazon prices appear only when checked within the last 24 hours, always with the time they were checked, and are never stored as price history (Amazon’s terms). eBay and Kelkoo prices are treated the same way.
  • No affiliate links are returned: each result links to our page, where the full comparison and our affiliate disclosure live.
  • We only answer for products we track. While our catalogue is still filling up many checks will come back empty — we log the request (no personal data) so we know what to add.

REST endpoints

Base URL https://hotwhathow.com/api/v1 · JSON · GET only · CORS open to every origin · region uk (GBP, default) or us (USD). The full schema is at /api/v1/openapi.json (OpenAPI 3.1).

GET /price-check?q=|gtin=|url=&region=
Exactly one of q (name / brand + model), gtin (barcode with a valid check digit) or url (a retailer product page — matched, never fetched). Up to 6 matches.
GET /search?q=&region=
Up to 10 tracked products.
GET /deals?region=
Up to 20 verified price drops: at least 14 days of history and today’s lowest total price below the product’s own 90-day average (never against RRP or a “was” price).
curl "https://hotwhathow.com/api/v1/price-check?q=sony+wh-1000xm5&region=uk"
curl "https://hotwhathow.com/api/v1/price-check?gtin=4548736132610&region=uk"
curl "https://hotwhathow.com/api/v1/price-check?url=https%3A%2F%2Fwww.example-retailer.co.uk%2Fp%2F12345"
curl "https://hotwhathow.com/api/v1/deals?region=uk"

Example response (abridged):

{
  "query": { "kind": "q", "value": "sony wh-1000xm5", "matchedBy": "search" },
  "region": "uk",
  "matches": [
    {
      "title": "Sony WH-1000XM5",
      "brand": "Sony",
      "category": "Headphones",
      "canonicalUrl": "https://hotwhathow.com/product/sony-wh-1000xm5/",
      "verdict": {
        "code": "GOOD_PRICE",
        "label": "Good price",
        "reason": "£40.00 below its 30-day median price across 4 retailers — …",
        "wasPrice": { "amount": 279, "currency": "GBP",
                      "basis": "lowest daily price in the 30 days before today" }
      },
      "lowestLandedPrice": { "amount": 249, "currency": "GBP", "merchant": "Example Retailer",
                             "checkedAt": "2026-11-17T09:05:00.000Z", "deliveryIncluded": true },
      "retailerCount": 4,
      "history": { "days": 90, "low90": { "amount": 245, "currency": "GBP" },
                   "median30": { "amount": 289, "currency": "GBP" },
                   "excludes": ["eBay Partner Network", "Kelkoo", "Amazon Associates"] },
      "isDemo": false
    }
  ],
  "disclosure": "HotWhatHow is reader-supported: …",
  "attribution": { "required": true, "text": "Price data from HotWhatHow — …",
                   "url": "https://hotwhathow.com/" },
  "generatedAt": "2026-11-17T09:06:12.000Z",
  "demo": false
}

Errors are JSON { "error", "message", "issues"? }: 400 invalid input, 429 rate limited (see Retry-After), 503 temporarily unavailable. Responses are cacheable for up to 5 minutes (never longer than an Amazon price in them stays current) and carry an ETag.

MCP server for AI assistants

https://hotwhathow.com/mcp speaks the Model Context Protocol over Streamable HTTP (stateless, JSON responses, no sign-in). Tools: check_price (q | gtin | url, region), search_products (q, region) and get_deals (region) — the same data as the REST API, plus a plain-text summary that cites our page and the disclosure.

Claude (desktop, web, mobile)

Settings → Connectors → Add custom connector → name “HotWhatHow”, URL https://hotwhathow.com/mcp. For a client that only runs local servers, bridge it with mcp-remote:

{
  "mcpServers": {
    "hotwhathow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hotwhathow.com/mcp"]
    }
  }
}

ChatGPT and other MCP clients

In ChatGPT, enable developer mode for connectors, then add a connector with the URL https://hotwhathow.com/mcp and no authentication. Any client that supports remote (Streamable HTTP) MCP servers works the same way. Menu names change often — check your client’s documentation.

curl -s https://hotwhathow.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"check_price","arguments":{"q":"ninja af300","region":"uk"}}}'

Rate limits & freshness

  • REST: 60 requests per minute per client; MCP: 60 requests per minute. Over the limit you get HTTP 429 with Retry-After.
  • Retailer data is refreshed at least daily; every price carries the time it was checked (checkedAt). Prices change — the retailer’s price at checkout applies.

Terms of use

  1. Attribution is required. Name HotWhatHow as the source and link each result to its canonicalUrl.
  2. No bulk scraping or mirroring. Query for real users’ questions; don’t crawl the catalogue, resell the data or build a copy of the price history.
  3. Show prices honestly: with the time they were checked and the disclosure, and don’t present our verdict as your own testing or as a guarantee.
  4. The service is provided as is, without warranty, and may change or be limited at any time. See also our terms, methodology and affiliate disclosure.

Disclosure returned with every result: HotWhatHow is reader-supported: we may earn a commission when you buy through links on our pages. It never changes which price we call the lowest — that is always the lowest total price including delivery among in-stock offers. Prices change often: check the retailer before buying. Amazon prices are shown only with the time they were checked and are never stored as price history.

Questions or higher limits? Contact us.