Stw APIstw.berlin ↗
Fetch daily and weekly canteen menus from studierendenWERK BERLIN. Get dish names, student/employee/guest prices, dietary labels, and all Mensa locations.
What is the Stw API?
This API provides access to canteen menu data from studierendenWERK BERLIN across 2 endpoints. Use list_canteens to retrieve all Mensa, Backshop, and Späti locations with their URLs, then call get_menu to pull full weekly or single-day menus per canteen — including dish names, category groupings, three-tier pricing, and dietary labels.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/d62db332-03b4-433e-962c-7796abc79384/list_canteens' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace stw-berlin-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: studierendenWERK BERLIN Canteen SDK — bounded, re-runnable."""
from parse_apis.studierendenwerk_berlin_canteen_api import StwBerlin, CanteenNotFound
client = StwBerlin()
# List all canteen locations — limit caps total items fetched.
for canteen in client.canteens.list(limit=5):
print(canteen.name, canteen.url)
# Drill into a single canteen's weekly menu.
canteen = client.canteens.list(limit=1).first()
if canteen:
menu = canteen.menu(week_offset=0)
print(menu.canteen, menu.resources_id)
# Walk through days and dishes.
for day in menu.days[:2]:
print(day.date)
for dish in day.menu[:3]:
print(dish.name, dish.category, dish.prices.student, dish.labels)
# Fetch menu for a specific date only.
if canteen:
menu_day = canteen.menu(date="2026-06-12")
for day in menu_day.days[:1]:
print(day.date, len(day.menu), "dishes")
# Typed error handling.
try:
bad = client.canteen(url="https://www.stw.berlin/mensen/einrichtungen/nonexistent.html")
bad.menu()
except CanteenNotFound as exc:
print(f"Canteen not found: {exc.canteen_url}")
print("exercised: canteens.list / canteen.menu (week) / canteen.menu (date) / CanteenNotFound")
Retrieves all canteen locations (Mensen, Backshops, Spätis) operated by studierendenWERK BERLIN across Berlin universities. Each canteen includes its display name and canonical page URL. The URL serves as the stable identifier for fetching menus via get_menu. No pagination — all locations returned in a single response.
No input parameters required.
{
"type": "object",
"fields": {
"canteens": "array of canteen objects, each with 'name' (string) and 'url' (string, full URL of the canteen page)"
},
"sample": {
"data": {
"canteens": [
{
"url": "https://www.stw.berlin/mensen/einrichtungen/freie-universit%C3%A4t-berlin/mensa-fu-ii.html",
"name": "Mensa FU II"
},
{
"url": "https://www.stw.berlin/mensen/einrichtungen/technische-universit%C3%A4t-berlin/mensa-tu-hardenbergstra%C3%9Fe.html",
"name": "Mensa TU / UdK Hardenbergstraße"
}
]
},
"status": "success"
}
}About the Stw API
Canteen Locations
The list_canteens endpoint returns an array of canteen objects, each containing a name (string) and a url (full URL to the canteen page on stw.berlin). This covers all studierendenWERK BERLIN locations, including Mensa dining halls, Backshop outlets, and Späti convenience spots at Berlin universities. The endpoint takes no parameters and is the expected first call to discover valid canteen_url values for use in menu requests.
Menu Data
The get_menu endpoint accepts three optional parameters: canteen_url (obtained from list_canteens), date (YYYY-MM-DD format for a single day), and week_offset (integer, 0 for current week, 1 for next week, etc.). By default it returns the full week from Monday to Saturday. The response includes a canteen string (location name), a resources_id (the internal canteen identifier), and a days array. Each element in days contains a date field and a menu array of dish objects.
Dish Details and Dietary Labels
Each dish object within the menu array includes: category (the serving counter or dish type grouping), name (full dish name in German as listed by the canteen), prices with separate values for students, employees, and guests, and labels for dietary and allergen classifications such as vegetarian, vegan, or pork indicators. The price structure reflects studierendenWERK BERLIN's standard three-tier pricing model.
The Stw API is a managed, monitored endpoint for stw.berlin — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when stw.berlin changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official stw.berlin API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a meal-planning app for Berlin university students that shows the weekly menu for their campus Mensa
- Display today's canteen options on a university intranet or digital notice board using the
dateparameter - Filter dishes by dietary labels (e.g. vegan, vegetarian) to surface suitable options for specific dietary needs
- Compare student vs. guest pricing across all canteen locations to help visitors estimate food costs
- Aggregate next week's menus across multiple canteens using
week_offset: 1to plan group lunches - Index canteen dish names and categories for a searchable campus food database
- Send automated daily lunch notifications to a Slack channel or Telegram bot with that day's menu
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does studierendenWERK BERLIN offer an official developer API?+
What does the `get_menu` endpoint return for a specific day versus a full week?+
date parameter (YYYY-MM-DD), the days array in the response contains only the entry for that date. Without a date, the endpoint returns all days from Monday through Saturday for the current or offset week. In both cases each day entry contains the same structure: a date string and a menu array of dishes with category, name, prices, and labels.Are allergen details or full nutritional information (calories, macros) included in the response?+
Does the API cover canteens outside the studierendenWERK BERLIN network, such as canteens at private universities or other German cities?+
How current is the menu data, and how far in advance are menus available?+
week_offset parameter lets you request future weeks, but results will be empty if the canteen has not yet published that week's menu.