Authentication
All API requests require authentication. Include your API key in the request headers:
Authorization: Bearer YOUR_API_KEY
To get your API key, contact support or check your Enterprise dashboard settings.
Base URL
https://magicplate.info/api
Restaurants API
GET
/restaurants
List all restaurants
GET /api/restaurants
POST
/restaurants
Create a new restaurant
POST /api/restaurants
Content-Type: application/json
{
"name": "Restaurant Name",
"cuisine": "Italian",
"subscription_tier": "professional"
}
GET
/restaurants/:id
Get restaurant details
Menus API
POST
/menus
Create a digital menu
POST /api/menus
Content-Type: application/json
{
"restaurant_id": 1,
"name": "Main Menu",
"items": [
{
"name": "Grilled Salmon",
"price": 24.99,
"description": "Fresh Atlantic salmon"
}
]
}
POST
/menus/generate-description
Generate SEO-optimized menu description using AI
HeyGen Avatar API
POST
/heygen/create-avatar
Create a restaurant avatar
POST
/heygen/generate-video
Generate a video with an avatar
Locations API
GET
/locations/:restaurant_id
List all locations for a restaurant
POST
/locations/:restaurant_id
Create a new location
POST
/locations/:location_id/sync
Sync content to a location with AI customization
Analytics API
GET
/analytics/:restaurant_id/dashboard
Get analytics dashboard data
GET
/analytics/:restaurant_id/insights
Get AI-powered insights and recommendations
Response Format
All API responses are in JSON format:
{
"success": true,
"data": { ... },
"message": "Operation completed successfully"
}
Error Responses
{
"error": "Error message",
"details": "Additional error details"
}
Rate Limits
| Plan |
Requests per Minute |
Requests per Day |
| Starter |
10 |
1,000 |
| Professional |
60 |
10,000 |
| Enterprise |
Unlimited |
Unlimited |
Need Help?
For API support, integration assistance, or to request additional endpoints: