openwein.de — deutsche Weingüter und Weinfeste

Lists all 13 German wine regions (Anbaugebiete) with their character, the number of wine towns and wineries in each, and how many events are coming up. Start here when the question is about German wine regions in general.

{
  "type": "object",
  "additionalProperties": false
}

Full description of one wine region: its history, grape varieties and terroir, plus its wine towns and upcoming events.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "Region alias, e.g. \"rheinhessen\", \"mosel-saar-ruwer\", \"ahr\". Use list_regions to see all."
    }
  },
  "required": [
    "region"
  ],
  "additionalProperties": false
}

Search ~5.900 German wineries by name, town, postal code or region, or geographically around a point. Filters for wineries that serve food (Straußwirtschaft, Gutsausschank), offer accommodation, or have a place for a camper van. Two further filters come from what a winery writes on its own website — grape variety and organic farming — and those two are deliberately incomplete: only about half of all wineries have a website that says so. Absence there is not evidence of absence. Returns contact details, address and coordinates.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text matched against winery name, owner and second name."
    },
    "region": {
      "type": "string",
      "description": "Region alias to restrict to."
    },
    "town": {
      "type": "string",
      "description": "Town name or alias, e.g. \"Nierstein\"."
    },
    "plz": {
      "type": "string",
      "description": "German postal code."
    },
    "lat": {
      "type": "number",
      "description": "Latitude for a radius search."
    },
    "lng": {
      "type": "number",
      "description": "Longitude for a radius search."
    },
    "radius_km": {
      "type": "number",
      "description": "Radius in km around lat/lng. Default 10."
    },
    "serves_food": {
      "type": "boolean",
      "description": "Only wineries with a Straußwirtschaft, Gutsausschank or restaurant."
    },
    "has_lodging": {
      "type": "boolean",
      "description": "Only wineries offering accommodation."
    },
    "has_caravan": {
      "type": "boolean",
      "description": "Only wineries with a camper van pitch."
    },
    "grape_variety": {
      "type": "string",
      "description": "Only wineries that NAME this grape variety on their own website, e.g. \"Riesling\". This is not a complete list of who grows it: a winery without a website, or one that does not list its varieties, is missing here."
    },
    "organic": {
      "type": "boolean",
      "description": "Only wineries that STATE organic farming on their own website. Not a certification check — same caveat as grape_variety."
    },
    "limit": {
      "type": "integer",
      "description": "Max results, 1-50. Default 20."
    }
  },
  "additionalProperties": false
}

Everything held about one winery: address, contact, opening hours, average rating, recent visitor comments, its upcoming events, the Einzellagen it names on its own website (which is not the same as the Lagen it farms — that is not publicly recorded), and a portrait assembled from its own website (hectares, grape varieties, organic farming, founding year) where that page could be read.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "description": "Winery id from search_wineries."
    },
    "url": {
      "type": "string",
      "description": "Alternatively its openwein.de URL or path, e.g. \"/rheinhessen/mainz-ebersheim/weingut-eva-vollmer\"."
    }
  },
  "additionalProperties": false
}

Upcoming German wine events — Weinfeste, Hoffeste, Weinproben, Weinwanderungen — across all regions, or filtered by region, town or a radius around a point. Every event carries the source it was verified against and a link to its own page; the result also names the human-readable calendar page for the same selection, which is the thing to hand a person rather than retelling a list that changes daily.

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Earliest date, YYYY-MM-DD. Defaults to today."
    },
    "to": {
      "type": "string",
      "description": "Latest date, YYYY-MM-DD. Defaults to one year out."
    },
    "region": {
      "type": "string",
      "description": "Region alias to restrict to."
    },
    "town": {
      "type": "string",
      "description": "Town name or alias to restrict to."
    },
    "lat": {
      "type": "number",
      "description": "Latitude for a radius search."
    },
    "lng": {
      "type": "number",
      "description": "Longitude for a radius search."
    },
    "radius_km": {
      "type": "number",
      "description": "Radius in km around lat/lng. Default 25."
    },
    "limit": {
      "type": "integer",
      "description": "Max results, 1-100. Default 40."
    }
  },
  "additionalProperties": false
}

Find German wine towns by name, region, postal code or around a point. Each town carries a description of its wine history and character, and the number of wineries listed there.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Town name, full or partial."
    },
    "region": {
      "type": "string",
      "description": "Region alias to restrict to."
    },
    "plz": {
      "type": "string",
      "description": "German postal code."
    },
    "lat": {
      "type": "number"
    },
    "lng": {
      "type": "number"
    },
    "radius_km": {
      "type": "number",
      "description": "Radius in km around lat/lng. Default 20."
    },
    "limit": {
      "type": "integer",
      "description": "Max results, 1-50. Default 20."
    }
  },
  "additionalProperties": false
}

Free-text search across the whole directory — winery names, owners, towns and description texts. Use this for open questions where the exact name is unknown ("a winery near the Mosel with rooms", "Riesling from steep slopes"). For a known town or a radius around coordinates, search_wineries is more precise.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What to look for, in German or English."
    },
    "region": {
      "type": "string",
      "description": "Region alias to restrict to."
    },
    "serves_food": {
      "type": "boolean",
      "description": "Only wineries that serve food."
    },
    "has_lodging": {
      "type": "boolean",
      "description": "Only wineries offering accommodation."
    },
    "has_caravan": {
      "type": "boolean",
      "description": "Only wineries with a camper van pitch."
    },
    "limit": {
      "type": "integer",
      "description": "Max results, 1-50. Default 20."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Search the 1.646 registered German Einzellagen (single vineyard sites) by name, town or region. The Einzellage is the smallest origin unit in German wine law and the name that appears on the label after the town ("Forster Ungeheuer", "Wehlener Sonnenuhr"). For the six regions of Rhineland-Palatinate the data is the official register of the Chamber of Agriculture and carries the vineyard number, Bereich, Großlage, planted area and the legal boundary; the Rheingau is currently sourced from Wikipedia and has no boundary. Note that a Lage name says where a wine grew, not how good it is. Where a winery names a Lage on its own website, get_lage returns that winery with the sentence it appeared in.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free text matched against the Lage name."
    },
    "region": {
      "type": "string",
      "description": "Region alias to restrict to."
    },
    "town": {
      "type": "string",
      "description": "Town name or alias, e.g. \"Kallstadt\"."
    },
    "grosslage": {
      "type": "string",
      "description": "Restrict to one Großlage."
    },
    "limit": {
      "type": "integer",
      "description": "Max results, 1-100. Default 25."
    }
  },
  "additionalProperties": false
}

One Einzellage in full: Bereich, Großlage, planted area, the official vineyard number, the municipalities it spans, and the wineries of its town. It is NOT known which wineries actually farm vines in a given Lage — no public register holds that — so the wineries listed are those located in the town, and the answer says so.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "Region alias."
    },
    "lage": {
      "type": "string",
      "description": "Lage alias from search_lagen."
    },
    "url": {
      "type": "string",
      "description": "Alternatively its openwein.de URL or path."
    }
  },
  "additionalProperties": false
}

What the weather did in one growing season, per wine region: mean temperature, sunshine hours and rainfall from April to October, compared with the 1991-2020 normal, plus the harvest volume where published. Measured data of the German Weather Service, for some regions back to 1881. IMPORTANT: these are measurements, not a verdict. A warm year is not a good year — what ends up in the glass depends on site, grape and winemaker. Do not present the numbers as a quality rating. Omit the year to get the whole series for a region.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "Region alias."
    },
    "year": {
      "type": "integer",
      "description": "Vintage year. Omitted: the whole series."
    },
    "from": {
      "type": "integer",
      "description": "Earliest year when returning a series."
    }
  },
  "additionalProperties": false
}

German wine terms explained, with their regional variants. Useful because the same institution carries different names by region: the seasonal tavern a winery runs itself is a Straußwirtschaft on the Mosel and in the Palatinate, a Besenwirtschaft in Württemberg and a Hecken- or Häckerwirtschaft in Franconia — and none of them is the same as a Gutsausschank, which may open all year. Omit the term to list all entries.

{
  "type": "object",
  "properties": {
    "term": {
      "type": "string",
      "description": "Term, alias or a synonym, e.g. \"Besen\"."
    },
    "category": {
      "type": "string",
      "description": "Restrict the listing to one category."
    }
  },
  "additionalProperties": false
}

One wine town in full: its description and wine history, every winery listed there, its upcoming events and the neighbouring wine towns.

{
  "type": "object",
  "properties": {
    "region": {
      "type": "string",
      "description": "Region alias."
    },
    "town": {
      "type": "string",
      "description": "Town alias, e.g. \"mainz-ebersheim\"."
    },
    "id": {
      "type": "integer",
      "description": "Alternatively the town id."
    }
  },
  "additionalProperties": false
}