TR Try for free
Menuz API · REST · JSON

Use your menu on your own site and app

One request returns your restaurant menu, categories and items as JSON. Create your key in the Menuz panel under Advanced settings > API access.

Overview

The Menuz API returns your menu as JSON so you can show it on your own website, app, kiosk or digital signage. Every change you make in the panel (price, item, sold-out state) shows up on the next request.

  • Base URLhttps://www.menuz.com.tr/api/public-menu.php
  • Formatapplication/json; charset=utf-8
  • AccessRead only (GET)
  • PlanChain and Resort plans

Authentication

Send your API key in the X-API-Key header with every request. The key belongs to your account and only reads your own restaurants.

HTTP
X-API-Key: YOUR_API_KEY

Where you cannot set headers you can pass the key as the api_key query parameter. URLs can end up in server logs, so the header is recommended.

URL
https://www.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve&api_key=YOUR_API_KEY

Endpoint

GET/api/public-menu.php

Returns one restaurant with its profile, active menus, categories and items in a single response.

ParameterInRequiredDescription
restaurantqueryYesThe restaurant slug from its menu URL. Example: menuz.com.tr/m/lale-kahve
X-API-KeyheaderYesYour API key.
api_keyqueryNoAlternative to the header.

Response

A successful response starts with ok: true. Prices are decimal strings ("85.00"); the currency is in restaurant.currency. is_available and is_featured are 1 or 0.

restaurant
id, name, slug, icon, description, address, phone, currency, currency_symbol, menu_theme, cover_url, theme_color

Restaurant profile.

menus[]
id, name, categories[]

Active menus only, in creation order.

categories[]
id, menu_id, name, icon, sort_order, items[]

In panel order (sort_order).

items[]
id, category_id, name, description, price, image_url, icon, is_available, is_featured, sort_order

Sold-out items are included (is_available = 0).

Sample response (200)
{
  "ok": true,
  "restaurant": {
    "id": 1,
    "user_id": 2,
    "name": "Lale Kahve",
    "slug": "lale-kahve",
    "emoji": null,
    "icon": "coffee",
    "description": null,
    "address": null,
    "phone": null,
    "currency": "TRY",
    "currency_symbol": "₺",
    "menu_theme": "kahve",
    "cover_url": "/assets/uploads/covers/cover-1.webp",
    "theme_color": "#9a3412"
  },
  "menus": [
    {
      "id": 1,
      "name": "Ana Menü",
      "categories": [
        {
          "id": 2,
          "menu_id": 1,
          "name": "Sıcak Kahveler",
          "emoji": null,
          "icon": "coffee",
          "sort_order": 0,
          "items": [
            {
              "id": 5,
              "category_id": 2,
              "name": "Türk kahvesi",
              "description": "Bakır cezvede, yanında lokum ile.",
              "price": "85.00",
              "image_url": null,
              "emoji": null,
              "icon": "coffee",
              "is_available": 1,
              "is_featured": 1,
              "sort_order": 0
            }
          ]
        }
      ]
    }
  ]
}

Errors

Errors always use the same body: {"ok": false, "error": "..."}

HTTPerrorWhat to do
200ok: trueSuccess. The body contains the menu data.
401Missing API key.No key was sent. Add the X-API-Key header.
403Invalid API key.The key is wrong or revoked. Create a new key in the panel.
422restaurant parameter is required.The restaurant parameter is empty.
404Restaurant not found.No restaurant with this slug, it is not yours, or it is inactive.

Rate limits and caching

No fixed rate limit is applied right now. Responses are not cached (Cache-Control: no-store), so every request returns fresh data. We recommend caching the response on your side for 1 to 5 minutes; that is enough for menu changes to show up.

Examples

Terminal
curl -s "https://www.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve" \
  -H "X-API-Key: YOUR_API_KEY"
PHP 8
<?php
$ch = curl_init('https://www.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 10,
    CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('MENUZ_API_KEY')],
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($body, true);
if ($status !== 200 || empty($data['ok'])) {
    throw new RuntimeException($data['error'] ?? 'Menuz API error');
}
foreach ($data['menus'] as $menu) {
    foreach ($menu['categories'] as $cat) {
        foreach ($cat['items'] as $item) {
            echo $item['name'], ': ', $item['price'], "\n";
        }
    }
}
Node.js
// Node.js 18+ (server side)
const res = await fetch('https://www.menuz.com.tr/api/public-menu.php?restaurant=lale-kahve', {
  headers: { 'X-API-Key': process.env.MENUZ_API_KEY },
});
const data = await res.json();
if (!res.ok || !data.ok) throw new Error(data.error);

for (const menu of data.menus) {
  for (const cat of menu.categories) {
    console.log(cat.name, cat.items.length);
  }
}

Security

  • Use the key on the server only. Do not put it in browser code or in a mobile app bundle.
  • Keep the key in an environment variable (for example MENUZ_API_KEY), not in your repository.
  • If you think the key leaked, rotate it in the panel. The old key stops working at once.