openwinemap.com

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "pattern": "^[a-z]{2}$",
      "description": "ISO 3166-1 alpha-2 code, lower-case."
    },
    "region": {
      "type": "string",
      "maxLength": 100,
      "description": "Wine region as shown on the map, e.g. \"Bourgogne\", \"Catalunya\", \"Mosel\"."
    },
    "style": {
      "type": "string",
      "maxLength": 100,
      "description": "Wine style slug or label, e.g. \"red\", \"white\", \"rose\", \"sparkling\", \"sweet\", \"fortified\", \"vin-jaune\"."
    },
    "grape": {
      "type": "string",
      "maxLength": 100,
      "description": "Grape variety name or slug, e.g. \"Garnacha\", \"pinot-noir\". Synonyms of the same VIVC variety are included."
    },
    "main_grape_only": {
      "type": "boolean",
      "description": "Only match the grape among the principal varieties (default false)."
    },
    "scheme": {
      "type": "string",
      "maxLength": 50,
      "description": "Legal scheme (pdo, pgi, spirit-gi, uk-pdo, uk-pgi, none) or traditional term (aoc, docg, doc, igt, doca, doq, dac, …; \"it:doc\" to name one country's)."
    },
    "include_sub_denominations": {
      "type": "boolean",
      "description": "Include sub-denominations (DGCs, subzonas, sottozone, crus); default false."
    },
    "include_spirits": {
      "type": "boolean",
      "description": "Include spirit-drink and cider GIs; default false."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Maximum results (default 50)."
    }
  }
}