Developers

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/mcp

Claude Code

claude mcp add --transport http gustu https://menu.gustu.ai/api/public/mcp

claude.ai

  1. Open Settings, then Connectors.
  2. Choose Add custom connector.
  3. Name it Gustu, paste the server URL above and save.
  4. 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/chat

Getting 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

Building something on it? Write to us.

Public menu and chat API — Gustu