Restaurant Intelligence Platform - APIs for the AI Restaurant Economy

The API Suite

Five APIs. One Intelligence Layer.

Every API is a single credential away. No restaurant legacy, no migration — just structured, computable restaurant intelligence.

Core API

Restaurant Knowledge API

Structured knowledge about restaurants, their menus and the people who dine there — ready for any AI model or application.

Restaurant profiles, hours & locations
Menu items with structured attributes
Customer segments & preference signals

GET/v1/restaurants/{id}

GET/v1/restaurants/search

GET/v1/restaurants/{id}/menu

GET/v1/customers/segments

// Fetch a restaurant with full menu intelligence
const res = await fetch('https://api.clawpos.com/v1/restaurants/1234?include=menu', {
  headers: { 'Authorization': 'Bearer YOUR_KEY' }
});
const data = await res.json();
// data.menu[0].ingredients → structured food graph

Semantic API

Menu Intelligence API

Understand every dish, ingredient and price across the world's menus — semantically, not just as unstructured text.

Dish classification & cuisine detection
Ingredient extraction & substitution
Price intelligence & margin estimation

POST/v1/menu/parse

GET/v1/menu/{id}/dishes

GET/v1/dishes/{id}/ingredients

GET/v1/menu/price-intelligence

// Parse an unstructured menu into intelligence
const parsed = await fetch('https://api.clawpos.com/v1/menu/parse', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ raw_menu_text })
});
// Returns dishes with cuisine, ingredients, allergens

Graph API

Food Graph API

Query the food knowledge graph — cuisine, ingredients, nutrition and preferences — as a living relational layer.

Graph traversal & relationship queries
Nutrition & dietary attribute lookup
Substitution & pairing recommendations

GET/v1/graph/nodes/{type}

GET/v1/graph/edges/{from}/{to}

POST/v1/graph/traverse

GET/v1/ingredients/{id}/nutrition

Analytics API

Turn raw operations data into forecasts, performance signals and action-ready business insight.

Sales forecasting & demand prediction
Menu performance & margin analysis
Anomaly detection & alerting

GET/v1/analytics/sales/forecast

GET/v1/analytics/menu/performance

POST/v1/analytics/anomalies

GET/v1/analytics/reports

Agent API

Build and deploy restaurant AI employees on a layer that already understands your business — no prompt engineering required.

Pre-built agent personas (COO, Marketing, Analytics)
Custom agent creation with restaurant context
Tool use & action execution framework

POST/v1/agents/create

POST/v1/agents/{id}/chat

GET/v1/agents/{id}/tasks

POST/v1/agents/{id}/execute

// Deploy a Claw Manager AI employee
const agent = await fetch('https://api.clawpos.com/v1/agents/create', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_KEY' },
  body: JSON.stringify({ persona: 'claw-manager', restaurant_id: '1234' })
});
// Agent monitors revenue, generates reports, recommends actions

Built For

Who Uses the Intelligence Platform

From AI startups to enterprise POS — one layer powers the entire restaurant AI ecosystem.

AI CompaniesRestaurant-ready intelligence for agents

POS PlatformsAdd intelligence to existing systems

Restaurant SaaSComposable intelligence, not another silo

Food TechnologyPower delivery, ghost kitchens & more

Developer Experience

Built for developers who ship fast.

RESTful APIs, typed SDKs, interactive docs and sandbox environments. Everything you need to go from first call to production in an afternoon.

Authentication

API keys with scoped permissions. Rotate, revoke and monitor every key from the developer dashboard.

Bearer token auth — one key, all APIs
Scoped keys (read-only, per-API, per-environment)
One-click rotation with graceful overlap period

API Keys OAuth 2.0 Webhook Signing

SDKs & Libraries

First-party, type-safe SDKs for the languages your team already uses. Auto-generated from our OpenAPI spec.

Paginated requests, retries and backoff built in
Full TypeScript types and Python dataclasses
Community SDKs for Go, Rust, PHP and Ruby

TypeScript Python Node.js Java Go cURL

# Query the Food Graph for ingredient substitutions
curl -X POST https://api.clawpos.com/v1/graph/traverse \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"node": "ingredient:mozzarella", "relation": "substitute", "depth": 2}'

API Specification

Production-grade, versioned and stable.

Every endpoint follows the same conventions. Predictable pagination, consistent error shapes, and versioning that never breaks your integration.

Convention	Specification	Details
Base URL	`https://api.clawpos.com/v1`	All requests over HTTPS. TLS 1.2+ required.
Versioning	URL path versioning (`/v1`)	New versions released as `/v2`; v1 maintained for 24 months after v2 launch.
Data format	JSON (request & response)	`Content-Type: application/json`. UTF-8 encoding.
Authentication	Bearer token in header	`Authorization: Bearer YOUR_API_KEY`
Pagination	Cursor-based	`?limit=50&cursor=...`. Response includes `next_cursor` when more data exists.
Rate limits	1,000 req/min (default)	Per API key. Burst allowance: 200 req/10s. Enterprise tiers configurable.
Rate limit headers	`X-RateLimit-*`	Limit, remaining, reset (Unix timestamp) returned on every response.
Errors	HTTP status + JSON body	Consistent shape: `{"error": {"code", "message", "details", "request_id"}}`
Idempotency	`Idempotency-Key` header	Safe retries for POST requests. Keys stored for 24 hours.
Timeouts	30s connect / 60s read	Long-running operations return async job IDs for polling.

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests. Limit: 1000/min.",
    "details": { "retry_after": "42s" },
    "request_id": "req_01HXYZ7K9P2Q3R4S5T6U7V8W9"
  }
}

Webhooks & Events

React to restaurant events in real time.

Don't poll — subscribe. ClawPOS sends signed webhooks when things happen in your restaurant data, from menu changes to anomaly alerts.

MENU

menu.updated

A restaurant's menu changed — new items, price updates, 86'd items or section reordering.

ANALYTICS

anomaly.detected

Claw Analytics flagged a statistical anomaly — revenue spike/drop, margin shift, unusual void rate.

AGENT

agent.action_taken

An AI employee executed an action — campaign launched, report generated, recommendation issued.

DATA

data.ingested

New batch of restaurant data successfully ingested and processed into the intelligence layer.

CUSTOMER

customer.segment_changed

A customer moved between segments — VIP → at-risk, new → regular, or churned → reactivated.

SYSTEM

integration.status

POS or data source connection status changed — connected, disconnected, or reconnected.

{
  "id": "wh_evt_01HXYZ...",
  "type": "anomaly.detected",
  "created": 1719504000,
  "data": {
    "restaurant_id": "rest_1234",
    "metric": "dinner_revenue",
    "deviation": "-22%",
    "severity": "high",
    "agent_url": "https://app.clawpos.com/agents/anomaly/abc123"
  }
}

Security & Compliance

Enterprise-grade security, by default.

Restaurant data is sensitive. We treat it that way — encrypted in transit and at rest, access-controlled, audited, and compliant with global data protection standards.

Encryption

TLS 1.2+ in transit. AES-256 at rest. Per-tenant encryption keys with customer-managed key option on Enterprise.

SOC 2 Type II

Independently audited security controls. Annual third-party penetration testing. Continuous vulnerability scanning.

GDPR & CCPA

Data processing agreements available. Right to access, rectify and delete. Data residency options (US, EU, APAC).

Access Control

RBAC with granular permissions. SSO (SAML 2.0, OIDC). SCIM provisioning. IP allowlisting on Enterprise.

Audit Logging

Every API call, data access and agent action logged with request IDs. Exportable audit trail for compliance reviews.

Data Retention

Configurable retention policies. Anonymization options. Right to be forgotten fulfilled within 30 days of request.

APIs for the AI Restaurant Economy