Every Gustu menu, one request away.
Restaurants on Gustu publish their menu as structured data. Assistants, search engines and your own code can read it without scraping: one GET, no API key.
The endpoint
GET https://menu.gustu.ai/api/public/v1/restaurants/{slug}/menu- slug
- The restaurant's slug, as in menu.gustu.ai/r/{slug}.
- branch
- Optional. The branch slug; required when the restaurant has more than one branch.
- lang
- Optional. A language code such as tr, en or de. Defaults to the restaurant's own language.
Example
curl https://menu.gustu.ai/api/public/v1/restaurants/cil/menu{
"schemaVersion": 1,
"language": "tr",
"restaurant": {
"slug": "cil",
"name": "Çil"
},
"branch": {
"slug": "moda",
"name": "Moda",
"address": "Caferağa, Moda Cd. No:101, 34710 Kadıköy/İstanbul, Türkiye"
},
"priceRange": {
"min": 425,
"max": 1495,
"currency": "TRY"
},
"itemCount": 115,
"sections": [
{
"name": "Paylaşımlıklar",
"items": [
{
"name": "Bruschetta Üçlüsü",
"price": 675,
"currency": "TRY",
"dietTags": [],
"allergens": [
"gluten",
"milk",
"fish"
],
"calories": 160,
"url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/66c917d4-0d9f-4ed5-aebf-6d4c5697acde"
}
]
}
],
"dietaryCoverage": {
"gluten_free": 1,
"high_protein": 1,
"vegan": 4,
"vegetarian": 18
},
"disclaimer": "Alerjen ve diyet bilgileri restoranın menü verisinden gelir. Mutfaklarda çapraz bulaşma olabilir; ciddi alerjisi olan misafirler sipariş vermeden önce personele danışmalıdır."
}A real response for Çil in Moda, abridged to one dish. The full response lists every available dish in every section.
Use it from an assistant
The same menus are available as an MCP server, so an assistant such as Claude can look up a restaurant, search its dishes with exact diet, allergen and price filters, and open a single dish. No key and no sign-in; the restaurant is an argument of each tool.
https://menu.gustu.ai/api/public/mcpClaude Code
claude mcp add --transport http gustu https://menu.gustu.ai/api/public/mcpclaude.ai
- Open Settings, then Connectors.
- Choose Add custom connector.
- Name it Gustu, paste the server URL above and save.
- In a new chat, ask for a restaurant by area or cuisine, for example seafood in Kadıköy, or by its slug, for example cil.
Tools
- find_restaurants
- Restaurants on Gustu in an area of Turkey, for a cuisine, or both, ranked by relevance only. With a date, the ones that take table requests show free times.
- get_restaurant
- The restaurant's profile and a compact menu: sections, dish names, prices and tags. Lists the branches when you need to pick one.
- search_menu
- Dishes that match a request in any language, filtered exactly by diet, excluded allergens, maximum price and dish type. Up to ten results.
- get_item
- One dish in full: description, price, diet tags, allergens and calories, with a link to its page.
- check_availability
- Free table times for a party size, on one day or up to seven, in the restaurant's local time.
- create_reservation
- Requests a table with the guest's name, phone and email. Holds it for ten minutes and emails a code and a Gustu link. The guest verifies on Gustu.
- confirm_reservation
- Marketing.developersPage.mcp.tools.confirm_reservation
- get_reservation
- The status of a request: waiting for the restaurant, confirmed, declined or cancelled.
- cancel_reservation
- Cancels a reservation the guest asked to cancel.
A table request is not a booking until the restaurant accepts it. The restaurant confirms or declines on its Gustu board, and the guest is emailed the answer. Only restaurants that have set their opening hours on Gustu take requests.
Chat API: the assistant in your own product
Restaurants on Gustu have a menu-aware assistant on their table QR codes. With an API key from the restaurant, the same assistant answers through your software: a WhatsApp bot, a website widget, a kiosk. One message in, an answer with dish cards out; the restaurant's plan pays for the turns.
POST https://menu.gustu.ai/api/public/v1/chatGetting a key
Keys belong to the restaurant. Its owner creates one in Gustu under Settings → API, optionally restricted to a single branch, and hands it to you. The full key is shown once at creation; Gustu keeps only a fingerprint. Send it as a bearer token, from your server.
Example
curl https://menu.gustu.ai/api/public/v1/chat \
-H "Authorization: Bearer gk_live_…" \
-H "Content-Type: application/json" \
-d '{ "message": "Paylaşmak için hafif bir başlangıç var mı?", "branch": "moda" }'{
"conversation_id": "a4292279-8c0b-4d94-9216-50332cdf57e9-58f1169a-977f-475c-b4dc-99d83b4c4dd7",
"language": "tr",
"text": "Paylaşımlık tabaklarda daha hafif hissettiren seçenekler de var.",
"items": [
{
"id": "01ea41f5-67b1-4637-9897-081731a804b1",
"name": "Kabuklu Edamame",
"description": "Sade veya soslu servis",
"price": 425,
"currency": "TRY",
"imageUrl": "https://wputtpujubqiqyfmnlau.supabase.co/storage/v1/object/public/menu-images/menu-items/cil/01ea41f5-67b1-4637-9897-081731a804b1-67zjwn.webp",
"url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/01ea41f5-67b1-4637-9897-081731a804b1",
"category": "Paylaşımlıklar",
"isAvailable": true,
"dietTags": [
"vegan"
],
"allergens": [
"soybeans"
],
"reason": "Sade edamame, taze ve hafif bir paylaşmalık başlangıç arıyorsanız iyi bir seçenek; menüde vegan olarak etiketli. Alerjen bilgisinde soya belirtiliyor."
},
{
"id": "bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81",
"name": "Enginar & Burrata",
"description": "Fırınlanmış Kekikli Enginar Kalbi, Kuzukulağı, Baby Ispanak, Burrata Peyniri, Narenciye Vinegret, Edamame",
"price": 745,
"currency": "TRY",
"imageUrl": "https://wputtpujubqiqyfmnlau.supabase.co/storage/v1/object/public/menu-images/menu-items/cil-2/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81-xlpkho.webp",
"url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81",
"category": "Paylaşımlıklar",
"isAvailable": true,
"dietTags": [
"vegetarian"
],
"allergens": [
"milk"
],
"reason": "Enginar, yeşillikler ve narenciye vinegretli bu tabak, daha taze ve ferah bir paylaşmalık arıyorsanız öne çıkıyor. Menüde vejetaryen olarak etiketli."
}
],
"suggestions": [
{
"label": "Salatalara bak",
"message": "Salataları gösterir misiniz?",
"itemId": null
},
{
"label": "Bir içecek öner",
"message": "Bu başlangıçlara eşlik edecek bir içecek önerir misiniz?",
"itemId": null
}
],
"usage": {
"turn": 1,
"turns_remaining_in_conversation": 99,
"credits_remaining": 8087
},
"request_id": "f9712b0f-ee3d-4577-ae41-c36056b5562d"
}A real answer for Çil in Moda, captured on 1 November 2026 and abridged: two of the three cards and two of the four suggested follow-ups are shown. The assistant's wording differs from call to call; the shape does not.
Continuing a conversation
The server keeps the history. Send the next message with the conversation_id from the last answer, and the assistant remembers what was said. Omit it to start a new conversation; only ids Gustu issued are accepted.
{ "message": "Salataları gösterir misiniz?",
"conversation_id": "a4292279-8c0b-4d94-9216-50332cdf57e9-58f1169a-977f-475c-b4dc-99d83b4c4dd7" }Streaming
Set stream to true to receive server-sent events instead of one JSON body: meta first, text deltas as the assistant writes, items and suggestions when a dish card is ready, then done with the usage line, or error.
event: meta
data: {"conversation_id": "a4292279-8c0b-4d94-9216-50332cdf57e9-5fb9959e-aaf0-4578-8c72-f3f6310b407e", "language": "tr", "request_id": "37c8fd5b-166e-48fe-8e06-e98e187ac8cf"}
event: text
data: {"delta": "Pay"}
event: text
data: {"delta": "laşıma u"}
: 16 more text events
event: text
data: {"delta": "kler de var."}
event: items
data: {"items": [{"id": "bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81", "name": "Enginar & Burrata", "description": "Fırınlanmış Kekikli Enginar Kalbi, Kuzukulağı, Baby Ispanak, Burrata Peyniri, Narenciye Vinegret, Edamame", "price": 745, "currency": "TRY", "imageUrl": "https://wputtpujubqiqyfmnlau.supabase.co/storage/v1/object/public/menu-images/menu-items/cil-2/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81-xlpkho.webp", "url": "https://menu.gustu.ai/t/12c463aa-e927-4287-98e9-a7471d6641fb/a4292279-8c0b-4d94-9216-50332cdf57e9/item/bfe4bf53-bbee-4936-a6bf-ed6aa99d0e81", "category": "Paylaşımlıklar", "isAvailable": true, "dietTags": ["vegetarian"], "allergens": ["milk"], "reason": "Paylaşmak için 3-4 kişilik olarak sunuluyor; enginar, kuzukulağı ve narenciye vinegretinin ferah-ekşimsi notaları zengin burratayla dengeleniyor."}]}
event: suggestions
data: {"suggestions": [{"label": "Salatalara bak", "message": "Salataları gösterir misiniz?", "itemId": null}, {"label": "Taze portakal suyu", "message": "Taze Portakal Suyu hakkında bilgi verir misiniz?", "itemId": "4b1ffc26-a027-447e-9edb-814c65d17f71"}]}
event: done
data: {"usage": {"turn": 1, "turns_remaining_in_conversation": 99, "credits_remaining": 8085}, "request_id": "37c8fd5b-166e-48fe-8e06-e98e187ac8cf"}A real stream for Çil in Moda, captured on 1 November 2026 and shown in part: three of its 19 text events, one of three cards and two of four suggested follow-ups. The line starting with a colon marks the cut; the API does not send it.
How it behaves
- Each answered turn is deducted from the restaurant's own plan. A timeout (504) or an empty answer is not billed. The usage line in every answer says what is left.
- Call it from your server. A request carrying a browser Origin is refused with 403 origin_not_allowed unless the key lists that origin, so a key in a browser cannot spend the restaurant's turns.
- Limits are per key: requests per minute (60 by default) and an optional daily cost cap, both set by the owner on the key. Over either you get 429 with Retry-After. If the limiter itself is unreachable the request is refused with 503 rather than let through unmetered.
- A key restricted to one branch answers only for that branch and refuses another with 403 branch_not_allowed. An unrestricted key on a multi-branch restaurant must name the branch, or gets 400 branch_required with the list.
- Cards come from the menu. The name, price, diet tags, allergens and link of every item are the restaurant's data, never the model's; the text is the assistant's.
- A revoked key stops at once with 403 api_key_revoked. A restaurant that turns off its public surface closes this API too (403 surface_disabled).
- Every refusal is { error: { code, message } }. The codes and the request schema are in the OpenAPI description below.
How it behaves
- No authentication and no key. CORS is open, so you can call it from a browser.
- Responses are cached for five minutes. A menu change reaches the API within that window.
- Rate limit: 60 requests per minute per IP. Over it you get 429 with Retry-After.
- A restaurant with several branches answers 300 with the list of branches until you name one with ?branch=.
- Restaurants decide: an owner who turns off the public menu in Gustu gets 403 here, and no structured data anywhere.
- Version 1 only grows. New optional fields may appear; nothing is removed or renamed without a /v2.
About allergen data
Allergens and diet tags come from the restaurant's own menu data. Kitchens can have cross-contact, so every response carries a disclaimer. Show it, and never tell a guest a dish is free of something because a tag is missing.
Also available
- OpenAPI 3.1 description
- llms.txt summary per restaurant, for language models
- schema.org Restaurant and Menu markup on every menu page