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 URL
https://menuz.com.tr/api/public-menu.php - Format
application/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.
X-API-Key: YOUR_API_KEYWhere 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.
https://menuz.com.tr/api/public-menu.php?restaurant=lale-kahve&api_key=YOUR_API_KEYEndpoint
/api/public-menu.phpReturns one restaurant with its profile, active menus, categories and items in a single response.
| Parameter | In | Required | Description |
|---|---|---|---|
restaurant | query | Yes | The restaurant slug from its menu URL. Example: menuz.com.tr/m/lale-kahve |
X-API-Key | header | Yes | Your API key. |
api_key | query | No | Alternative 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.
restaurantRestaurant profile.
menus[]Active menus only, in creation order.
categories[]In panel order (sort_order).
items[]Sold-out items are included (is_available = 0).
{
"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": "..."}
| HTTP | error | What to do |
|---|---|---|
| 200 | ok: true | Success. The body contains the menu data. |
| 401 | Missing API key. | No key was sent. Add the X-API-Key header. |
| 403 | Invalid API key. | The key is wrong or revoked. Create a new key in the panel. |
| 422 | restaurant parameter is required. | The restaurant parameter is empty. |
| 404 | Restaurant 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
curl -s "https://menuz.com.tr/api/public-menu.php?restaurant=lale-kahve" \
-H "X-API-Key: YOUR_API_KEY"<?php
$ch = curl_init('https://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 18+ (server side)
const res = await fetch('https://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.