HotShot Gear

Recommends up to three darts-equipment items (steel-tip and soft-tip darts, bristle and electronic dartboards, flights, shafts, cases, oche mats, lighting, surrounds) from a curated UK catalogue, ranked by fit, not by payment. Each result gives the fit score, the reasons, the specs, the evidence links (maker spec sheet and an independent review) and a link to the item's page on hotshot.kwixa.co.uk where the person can see current prices and where to buy. Prices are in GBP and were checked on the date shown. The ranking rule is published as the fit_rule resource. An empty result means nothing in the catalogue clears the fit floor; say so rather than guessing.

{
  "type": "object",
  "properties": {
    "need": {
      "type": "string",
      "description": "What the person wants, in their words, e.g. \"first set of darts for a heavy thrower under £40\" or \"a board for a garage with little space\"."
    },
    "budget_gbp": {
      "type": "number",
      "description": "Maximum price in GBP, if stated."
    },
    "level": {
      "type": "string",
      "enum": [
        "beginner",
        "intermediate",
        "advanced"
      ]
    },
    "category": {
      "type": "string",
      "enum": [
        "steel-darts",
        "soft-darts",
        "bristle-board",
        "electronic-board",
        "flights",
        "shafts",
        "case",
        "mat",
        "lighting",
        "surround",
        "accessory"
      ]
    },
    "tip": {
      "type": "string",
      "enum": [
        "steel",
        "soft"
      ],
      "description": "Steel-tip (bristle board) or soft-tip (electronic board)."
    },
    "throw": {
      "type": "string",
      "enum": [
        "light",
        "medium",
        "heavy"
      ],
      "description": "Preferred dart weight class: light under 21 g, medium 21–24 g, heavy over 24 g."
    },
    "use": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "home",
          "pub",
          "league",
          "practice",
          "kids",
          "garage",
          "travel",
          "gift"
        ]
      }
    },
    "left_handed": {
      "type": "boolean"
    },
    "region": {
      "type": "string",
      "description": "Only \"uk\" is covered in version 1."
    }
  },
  "required": [
    "need"
  ]
}

Returns the full record for one item by id (ids come from find_gear): specs, fit fields, why and why not, evidence links, retailers that stock it (names only, no links), provenance and when it was last checked.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Side-by-side specs and fit notes for two or three catalogue items by id.

{
  "type": "object",
  "properties": {
    "ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 2,
      "maxItems": 3
    }
  },
  "required": [
    "ids"
  ]
}