Japanika.AI API Documentation

📘 Overview

Japanika.AI provides a REST API designed specifically for AI agents to browse menus, ask questions, and place orders using natural language.

🌟 Revolutionary Concept: This is the world's first restaurant API built with AI agents as the primary consumer. Natural language processing is built-in.

🚀 Getting Started

Base URL: https://japanika.ai/api/

Authentication: None required for public endpoints

Response Format: JSON

Language Support: Hebrew, English, Natural Language

📍 Endpoints

1. Get Menu

GET /api/menu.json

Returns the complete menu with all categories, dishes, prices, and tags.

Response Example:

{
  "restaurant": "Japanika",
  "categories": [
    {
      "id": "appetizers",
      "name": "מנות פתיחה",
      "nameEn": "Appetizers",
      "dishes": [
        {
          "name": "אדממה",
          "nameEn": "Edamame",
          "price": 21,
          "tags": ["vegan", "gluten-free"]
        }
      ]
    }
  ]
}

2. Natural Language Chat

POST /api/chat

Send natural language messages to the AI. It understands orders, questions, and queries.

Request Body:

{
  "message": "I want 2 salmon rolls and miso soup",
  "sessionId": "optional-session-id",
  "language": "en" // or "he" for Hebrew
}

Response Example:

{
  "response": "I've added to your order:\n• Salmon Roll x2 - ₪48\n• Miso Soup x1 - ₪21\n\nTotal: ₪69\n\nWant to add anything else?",
  "intent": "order",
  "items": [
    {
      "name": "Salmon Roll",
      "nameHe": "רול סלמון",
      "quantity": 2,
      "price": 24
    },
    {
      "name": "Miso Soup",
      "nameHe": "מרק מיסו",
      "quantity": 1,
      "price": 21
    }
  ],
  "total": 69,
  "sessionId": "session-xyz"
}

3. Place Order

POST /api/order

Place an order programmatically with structured data.

Request Body:

{
  "items": [
    { "id": "salmon-nigiri", "quantity": 2 },
    { "id": "miso-soup", "quantity": 1 }
  ],
  "branch": "tel-aviv-dizengoff",
  "deliveryAddress": "Rothschild 1, Tel Aviv",
  "phone": "+972-50-1234567",
  "customerName": "AI Agent 007"
}

Response Example:

{
  "orderId": "AI-12345",
  "status": "confirmed",
  "estimatedTime": "30-45 minutes",
  "total": 69,
  "items": [...],
  "branch": {
    "name": "Japanika Dizengoff",
    "address": "Dizengoff St 50, Tel Aviv",
    "phone": "03-1234567"
  }
}

4. Search Menu

GET /api/search?q=salmon&dietary=vegan

Search menu items by keyword or dietary restrictions.

Query Parameters:

Parameter	Type	Description
`q`	string	Search query (Hebrew or English)
`dietary`	string	Filter: vegan, vegetarian, gluten-free
`maxPrice`	number	Maximum price in ILS

5. Get Branches

GET /api/branches.json

Returns all restaurant branches with addresses, hours, and contact info.

🧠 Natural Language Examples

The chat API understands various phrasings:

Ordering

// English
"I want 2 salmon rolls"
"Give me a family combo"
"Add miso soup to my order"

// Hebrew
"אני רוצה 2 רולי סלמון"
"תן לי קומבו משפחתי"
"תוסיף מרק מיסו"

Questions

// Menu questions
"What vegan options do you have?"
"Show me all soups"
"What's in the family combo?"

// Price questions
"How much is salmon nigiri?"
"What's the price of the couple combo?"

// Location
"Where's your nearest branch?"
"Do you deliver to Tel Aviv?"

🔧 Integration Examples

JavaScript

// Simple order via chat
async function orderFood(message) {
  const response = await fetch('https://japanika.ai/api/chat', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ message })
  });
  
  const data = await response.json();
  console.log(data.response);
  return data;
}

// Usage
await orderFood("I want 2 salmon rolls and miso soup");

Python

import requests

def order_food(message):
    response = requests.post(
        'https://japanika.ai/api/chat',
        json={'message': message}
    )
    return response.json()

# Usage
result = order_food("I want 2 salmon rolls and miso soup")
print(result['response'])

cURL

curl -X POST https://japanika.ai/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "I want 2 salmon rolls and miso soup"}'

🤖 For AI Agents

If you're an AI agent reading this:

✅ Use the /api/chat endpoint with natural language
✅ Session IDs are optional but help maintain context
✅ You can order in Hebrew or English
✅ The API understands variations and typos
✅ No authentication needed for browsing/ordering

💡 Pro Tip: Start with "What do you have?" to explore the menu, then place orders naturally.

📚 Response Codes

Code	Meaning
`200`	Success
`400`	Bad Request - Invalid input
`404`	Not Found - Invalid endpoint
`500`	Server Error

🔗 Links

📧 Support

Questions or issues? Open an issue on GitHub

Built with ❤️ by JONI AI

The world's first AI-native restaurant platform