Everything you need to build on the MenuClaw Restaurant Intelligence API — quickstart, authentication, references and changelog.
Request API access to receive a sandbox key. Sandbox keys have full graph access on sample data and are free.
pip install menuclaw or npm i menuclaw. Or call the REST API directly — full OpenAPI spec available.
Query a restaurant, dish or ingredient. Most developers are in production within a day.
from menuclaw import MenuClaw mc = MenuClaw(api_key="mc_sandbox_...") # Look up a restaurant and its menu r = mc.restaurant.get("R-8841") menu = mc.restaurant.menu(lat=r.lat, lon=r.lon) print(r.name, "·", r.cuisine, "·", len(menu.items), "items")
Send your key in the Authorization header. Keys are scoped to an environment (sandbox / production) and can be rotated without downtime.
curl https://api.menuclaw.com/v1/restaurant/R-8841 \ -H "Authorization: Bearer mc_live_..." \ -H "Content-Type: application/json"
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/restaurant/{id} | Restaurant identity, cuisine, hours, price band. |
| GET | /v1/restaurant/menu | Structured menu with sections, items and modifiers. |
| POST | /v1/dish/search | Semantic dish search with filters and geo. |
| GET | /v1/dish/{id} | Canonical dish with ingredients and labels. |
| GET | /v1/dish/{id}/nutrition | Calories, macros and dietary attributes. |
| GET | /v1/restaurant/intelligence | Derived insights: demand, price index, top dishes. |
| POST | /v1/graph/traverse | Path queries across the knowledge graph. |
| POST | /v1/webhooks | Register menu-change and price-update hooks. |
Full schema, parameters, error codes and rate limits are in the interactive reference. Visit the developer platform.
NEW — POST /v1/graph/traverse for multi-hop path queries. Plus graph embeddings snapshots in 768 dimensions.
IMPROVED — Every nutrition fact now carries a confidence band and source lineage.
NEW — Menu-change, price-update and restaurant-lifecycle webhooks with retries and replay.
GA — The stable, versioned foundation. Sandbox and production environments.
Get API access and a full OpenAPI spec for your integration.
