search_schema.json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "E-commerce Product Search",
  "name": "product_search",
  "description": "A schema for searching products using a free-text query and a set of filters.",
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The free-form text query to search for products."
    },
    "price_min": {
      "type": "number",
      "description": "The minimum price."
    },
    "price_max": {
      "type": "number",
      "description": "The maximum price."
    },
    "average_rating_min": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "The minimum average rating (0-5)."
    },
    "average_rating_max": {
      "type": "number",
      "minimum": 0,
      "maximum": 5,
      "description": "The maximum average rating (0-5)."
    },
    "category": {
      "type": "string",
      "description": "The top-level category of the product.",
      "enum": [
        "amazon devices & accessories",
        "appliances",
        "arts, crafts & sewing",
        "automotive",
        "baby products",
        "beauty & personal care",
        "books",
        "car & vehicle electronics",
        "cds & vinyl",
        "cell phones & accessories",
        "clothing, shoes & jewelry",
        "dining & entertaining",
        "electronics",
        "food service equipment & supplies",
        "grills & outdoor cooking",
        "grocery & gourmet food",
        "handmade products",
        "health & household",
        "home & kitchen",
        "industrial & scientific",
        "kindle store",
        "kitchen & dining",
        "luxury stores",
        "medical supplies & equipment",
        "mobility & daily living aids",
        "movies & tv",
        "musical instruments",
        "office electronics",
        "office products",
        "patio, lawn & garden",
        "pet supplies",
        "power & hand tools",
        "small appliance parts & accessories",
        "software",
        "sports & outdoor recreation accessories",
        "sports & outdoors",
        "tools & home improvement",
        "toys & games",
        "video games"
      ]
    },
    "country_of_origin": {
      "type": "string",
      "description": "The country of origin of the product.",
      "enum": [
        "afghanistan",
        "albania",
        "algeria",
        "american samoa",
        "andorra",
        "angola",
        "anguilla",
        "antigua and barbuda",
        "argentina",
        "armenia",
        "australia",
        "austria",
        "azerbaijan",
        "bahamas",
        "bahrain",
        "bangladesh",
        "barbados",
        "belarus",
        "belgium",
        "benin",
        "bhutan",
        "bolivia",
        "bosnia and herzegovina",
        "bouvet island",
        "brazil",
        "british indian ocean territory",
        "brunei darussalam",
        "bulgaria",
        "cambodia",
        "cameroon",
        "canada",
        "cape verde",
        "cayman islands",
        "central african republic",
        "chile",
        "china",
        "cocos (keeling) islands",
        "colombia",
        "costa rica",
        "cote d'ivoire",
        "croatia",
        "czech republic",
        "denmark",
        "dominican republic",
        "ecuador",
        "egypt",
        "el salvador",
        "estonia",
        "ethiopia",
        "fiji",
        "finland",
        "france",
        "georgia",
        "germany",
        "ghana",
        "greece",
        "guatemala",
        "haiti",
        "honduras",
        "hong kong",
        "hungary",
        "iceland",
        "india",
        "indonesia",
        "ireland",
        "israel",
        "italy",
        "jamaica",
        "japan",
        "jordan",
        "kazakhstan",
        "kenya",
        "korea, republic of",
        "kuwait",
        "kyrgyzstan",
        "latvia",
        "lebanon",
        "lesotho",
        "liberia",
        "liechtenstein",
        "lithuania",
        "luxembourg",
        "macau",
        "macedonia",
        "madagascar",
        "malaysia",
        "mauritius",
        "mexico",
        "monaco",
        "mongolia",
        "morocco",
        "myanmar",
        "namibia",
        "nepal",
        "netherlands",
        "netherlands antilles",
        "new caledonia",
        "new zealand",
        "nicaragua",
        "nigeria",
        "norway",
        "oman",
        "pakistan",
        "panama",
        "papua new guinea",
        "paraguay",
        "peru",
        "philippines",
        "poland",
        "portugal",
        "puerto rico",
        "qatar",
        "republic of korea",
        "romania",
        "russian federation",
        "rwanda",
        "saint martin",
        "saint vincent and the grenadines",
        "saudi arabia",
        "seychelles",
        "sierra leone",
        "singapore",
        "slovakia",
        "slovenia",
        "solomon islands",
        "south africa",
        "spain",
        "sri lanka",
        "st. helena",
        "svalbard and jan mayen islands",
        "swaziland",
        "sweden",
        "switzerland",
        "taiwan",
        "tajikistan",
        "tanzania",
        "thailand",
        "togo",
        "trinidad and tobago",
        "tunisia",
        "turkey",
        "tuvalu",
        "uganda",
        "ukraine",
        "united arab emirates",
        "united kingdom",
        "united states",
        "united states minor outlying islands",
        "uruguay",
        "usa",
        "uzbekistan",
        "venezuela",
        "vietnam",
        "virgin islands (british)",
        "virgin islands (u.s.)",
        "yemen",
        "zimbabwe"
      ]
    },
    "brand": {
      "type": "string",
      "description": "A search query for the product's brand."
    },
    "manufacturer": {
      "type": "string",
      "description": "A search query for the product's manufacturer."
    },
    "color": {
      "type": "string",
      "description": "The color of the product. Constrained to a list of known, common colors.",
      "enum": [
        "amber",
        "antique brass",
        "antique bronze",
        "antique white",
        "apricot",
        "beige",
        "black",
        "blue",
        "bronze",
        "brown",
        "burgundy",
        "charcoal",
        "coffee",
        "copper",
        "cream",
        "cyan",
        "dark blue",
        "dark brown",
        "dark gray",
        "dark green",
        "eggshell",
        "gold",
        "gray",
        "green",
        "grey",
        "hot pink",
        "ivory",
        "khaki",
        "lavender",
        "light brown",
        "linen",
        "mahogany",
        "navy blue",
        "nickel",
        "orange",
        "pink",
        "platinum",
        "purple",
        "red",
        "rose",
        "rust",
        "sea blue",
        "silver",
        "sunset",
        "tan",
        "teal",
        "turquoise",
        "white",
        "wine red",
        "yellow"
      ]
    },
    "material": {
      "type": "string",
      "description": "A search query for the product's material."
    },
    "style": {
      "type": "string",
      "description": "A search query for the product's style."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}