electricskateboard

Finds products by name or brand across about 480 shops. Returns, for each match, the cheapest shop, how many shops carry it, our verdict on the price, and the product URL.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Product name or brand, e.g. \"Meepo V5\" or \"Onewheel Pint\"."
    },
    "brand": {
      "type": "string",
      "description": "Brand name, e.g. \"Meepo\", \"Onewheel\", \"Exway\"."
    },
    "vehicle": {
      "type": "string",
      "description": "One of: electric-skateboard, electric-scooter, onewheel, electric-bike, skateboard."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code of the shop charging the best price, e.g. \"US\", \"CA\", \"DE\"."
    },
    "in_stock_only": {
      "type": "boolean",
      "description": "Keep only products the cheapest shop actually has in stock."
    },
    "max_price": {
      "type": "number",
      "description": "Upper bound on the best price. Requires `currency` — we never convert, so this only filters products priced in that currency."
    },
    "currency": {
      "type": "string",
      "description": "Currency for max_price: USD, CAD, EUR, GBP, AUD. Defaults to USD."
    },
    "limit": {
      "type": "integer",
      "description": "How many results (default 10, max 50)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

The full price picture of one product: every shop we read, their price and stock, the spread, and whether a dated archive capture contradicts the claim that today is its lowest.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "A product URL or path on electricskateboard.com, e.g. \"/decks/onewheel/gt-s-series-11db9\"."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

Claims we can defend today, by kind: real_deal (cheapest anywhere, or a sale a competitor confirms), just_dropped (fell since our last reading), lowest_we_have_seen, cheaper_than_years_ago (beats a dated capture), you_just_missed_it (climbed back), and last_one_standing (at least three shops carry it and exactly one can still ship it — a scarcity fact no single shop can report about itself). Recomputed twice a day.

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "real_deal",
        "just_dropped",
        "lowest_we_have_seen",
        "cheaper_than_years_ago",
        "you_just_missed_it",
        "last_one_standing"
      ],
      "description": "Which list. Defaults to real_deal."
    },
    "brand": {
      "type": "string",
      "description": "Brand name, e.g. \"Meepo\", \"Onewheel\", \"Exway\"."
    },
    "vehicle": {
      "type": "string",
      "description": "One of: electric-skateboard, electric-scooter, onewheel, electric-bike, skateboard."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code of the shop charging the best price, e.g. \"US\", \"CA\", \"DE\"."
    },
    "in_stock_only": {
      "type": "boolean",
      "description": "Keep only products the cheapest shop actually has in stock."
    },
    "max_price": {
      "type": "number",
      "description": "Upper bound on the best price. Requires `currency` — we never convert, so this only filters products priced in that currency."
    },
    "currency": {
      "type": "string",
      "description": "Currency for max_price: USD, CAD, EUR, GBP, AUD. Defaults to USD."
    },
    "limit": {
      "type": "integer",
      "description": "How many results (default 10, max 50)."
    }
  },
  "additionalProperties": false
}

Products where one shop advertises a discount while another quietly charges less for the same thing, or where the crossed-out price is one nobody actually charges.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand name, e.g. \"Meepo\", \"Onewheel\", \"Exway\"."
    },
    "vehicle": {
      "type": "string",
      "description": "One of: electric-skateboard, electric-scooter, onewheel, electric-bike, skateboard."
    },
    "limit": {
      "type": "integer",
      "description": "How many results (default 10, max 50)."
    }
  },
  "additionalProperties": false
}

Dated captures of one product page from the Internet Archive, oldest first, with today's price at the same shop as the last point, and the number of captures found (fewer than two means the past price is unknown).

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "A product URL or path on electricskateboard.com, e.g. \"/decks/onewheel/gt-s-series-11db9\"."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false
}

For a brand or a country: the shops we read that carry it, ranked by how many genuine deals they actually have, plus how often they badge a discount versus how often that discount survives comparison.

{
  "type": "object",
  "properties": {
    "brand": {
      "type": "string",
      "description": "Brand name. Either brand or country is required."
    },
    "country": {
      "type": "string",
      "description": "Two-letter country code, e.g. \"US\", \"CA\", \"DE\"."
    },
    "limit": {
      "type": "integer",
      "description": "How many results (default 10, max 50)."
    }
  },
  "additionalProperties": false
}

For one of the 50 US states, 13 Canadian provinces and territories, 8 Australian states and territories, or the United Kingdom, New Zealand, Singapore, Hong Kong, Germany, France, the Netherlands, Spain, Austria and Switzerland: whether any statute names the electric skateboard, what it requires, the exact words of the law with section numbers, links to the primary sources and the date each was read. Statuses: encadre (a statute names it and sets conditions), interdit (not allowed on public roads), sans-texte (no statute names it), nomme-sans-regles (named, but no operating rules). Information from the statutes, not legal advice.

{
  "type": "object",
  "properties": {
    "jurisdiction": {
      "type": "string",
      "description": "State or province name or code, e.g. \"Michigan\", \"MI\", \"Quebec\", \"QC\", \"us-ca\"."
    }
  },
  "required": [
    "jurisdiction"
  ],
  "additionalProperties": false
}