Comparr

Compare the prices of a product category or a specific model across merchants (France on comparr.fr, United States on comparr.co). Returns ranked products with every offer, the exact seller, the item condition and the date each price was checked. If no comparison exists yet, one is started and the result has status 'pending' with retry_after_seconds: the full results are available about 60 seconds later for the same query.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the user is looking for, in their own words (e.g. \"casque bluetooth réduction de bruit\", \"Dyson V8\")."
    },
    "max_price": {
      "type": "number",
      "description": "Optional budget in the market currency (EUR or USD). Products whose best price is above it are left out."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Number of products to return (default 8)."
    }
  },
  "required": [
    "query"
  ]
}

All current offers for one product (id or slug from search_products or get_deals), with the date each price was checked, the exact seller, the condition, and a 'is now a good time to buy' verdict computed from Comparr's recorded price history.

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "description": "Product id or slug."
    }
  },
  "required": [
    "product"
  ]
}

Recorded price history of one product: best price per day across all offers AND the series of each individual offer, which tells a real price drop apart from a cheaper seller appearing. Readings are periodic, dated snapshots (often weekly), not daily tracking.

{
  "type": "object",
  "properties": {
    "product": {
      "type": "string",
      "description": "Product id or slug."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365,
      "description": "Window in days (default 180)."
    }
  },
  "required": [
    "product"
  ]
}

Current verified price drops: the SAME offer is cheaper than its own lowest recorded price over the previous 90 days, backed by several days of readings, checked within 48 h, new condition only, Amazon offers re-verified. Each deal returns its proof (reference price, period, number of reading days). Optionally filter by words in the product name.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional words the product name must contain (e.g. \"bouilloire\", \"airpods\")."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 40,
      "description": "Number of deals (default 20)."
    }
  }
}