smartphonechecker.co.uk

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Optional manufacturer/model text, 2–120 characters when supplied. Omit for structured discovery.",
      "minLength": 2,
      "maxLength": 120
    },
    "productType": {
      "type": "string",
      "description": "Optional device category.",
      "enum": [
        "phone",
        "tablet",
        "smartwatch",
        "mifi",
        "usb_modem",
        "home_router"
      ]
    },
    "manufacturer": {
      "type": "string",
      "description": "Optional manufacturer name, matched case-insensitively.",
      "minLength": 1,
      "maxLength": 80
    },
    "operatingSystem": {
      "type": "string",
      "description": "Optional operating-system text, such as Android or iOS, matched case-insensitively within recorded specifications.",
      "minLength": 1,
      "maxLength": 80
    },
    "minReleaseYear": {
      "type": "integer",
      "description": "Earliest recorded release year, inclusive. Unknown release years do not match; catalogue-added dates are not release dates. Set both year bounds equal for one year.",
      "minimum": 1990,
      "maximum": 2100
    },
    "maxReleaseYear": {
      "type": "integer",
      "description": "Latest recorded release year, inclusive. Devices with unknown release years do not match.",
      "minimum": 1990,
      "maximum": 2100
    },
    "minScreenSizeInches": {
      "type": "number",
      "description": "Minimum screen diagonal in inches, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 100,
      "multipleOf": 0.01
    },
    "maxScreenSizeInches": {
      "type": "number",
      "description": "Maximum screen diagonal in inches, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 100,
      "multipleOf": 0.01
    },
    "minHeightMm": {
      "type": "number",
      "description": "Minimum device height in millimetres, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 2000,
      "multipleOf": 0.01
    },
    "maxHeightMm": {
      "type": "number",
      "description": "Maximum device height in millimetres, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 2000,
      "multipleOf": 0.01
    },
    "minWidthMm": {
      "type": "number",
      "description": "Minimum device width in millimetres, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 2000,
      "multipleOf": 0.01
    },
    "maxWidthMm": {
      "type": "number",
      "description": "Maximum device width in millimetres, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 2000,
      "multipleOf": 0.01
    },
    "minDepthMm": {
      "type": "number",
      "description": "Minimum device depth (thickness) in millimetres, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 2000,
      "multipleOf": 0.01
    },
    "maxDepthMm": {
      "type": "number",
      "description": "Maximum device depth (thickness) in millimetres, inclusive. Unknown or ambiguous measurements do not match.",
      "minimum": 0.01,
      "maximum": 2000,
      "multipleOf": 0.01
    },
    "minStorageGb": {
      "type": "integer",
      "description": "Minimum recorded storage capacity in GB.",
      "minimum": 1,
      "maximum": 16384
    },
    "minReviewScore": {
      "type": "number",
      "description": "Minimum average review score out of 5, to one decimal place; devices without reviews are excluded.",
      "minimum": 0,
      "maximum": 5,
      "multipleOf": 0.1
    },
    "dealType": {
      "type": "string",
      "description": "Optional requirement for eligible contract, SIM-free or upgrade deals. Price filters default to contracts when this is omitted.",
      "enum": [
        "contract",
        "sim_free",
        "upgrade"
      ]
    },
    "maxMonthlyGbp": {
      "type": "number",
      "description": "Maximum monthly deal price in GBP; applies to contract or upgrade discovery. For SIM-free use maxUpfrontGbp.",
      "minimum": 0,
      "maximum": 100000,
      "multipleOf": 0.01
    },
    "maxUpfrontGbp": {
      "type": "number",
      "description": "Maximum upfront price in GBP; the purchase budget for SIM-free discovery.",
      "minimum": 0,
      "maximum": 100000,
      "multipleOf": 0.01
    },
    "sort": {
      "type": "string",
      "description": "Order by relevance (eligible offers first), newest release year, or highest average review score.",
      "enum": [
        "relevance",
        "newest",
        "review_score"
      ],
      "default": "relevance"
    },
    "page": {
      "type": "integer",
      "description": "One-based page of up to 20 devices.",
      "minimum": 1,
      "maximum": 100,
      "default": 1
    }
  },
  "required": [],
  "additionalProperties": false
}