Culinary Recipe Directory & Catalog - API | Diets Premium Skip to main content
Production REST API • High Performance POST /api/v1/recipe Culinary Database

Recipe & Culinary Meal Database

Curated collection of clinical and gourmet recipes with step-by-step culinary instructions, exact ingredient portion gram weights, preparation times, difficulty levels, and full macro breakdowns.

Protocol
HTTPS / REST
Auth Type
Bearer Token / Free Tier
Format
application/json
Average Latency
< 15ms

Endpoint URL & Request Headers

Send standard HTTP POST requests with JSON body.

Full Request URL
https://www.dietspremium.com/api/v1/recipe
Required Headers
Authorization: Bearer YOUR_API_KEY (optional for free tier)
Content-Type: application/json
Accept: application/json

Request Parameters

Accepted keys in the JSON body payload.

Parameter Type Status Default Description
query string required — Recipe phrase (e.g. "quick keto avocado salmon salad")
locale string optional en Target locale
ai boolean optional true AI semantic search

Integration Code Examples

Ready-to-use snippets for your backend or frontend stack.

cURL / JavaScript / Python / PHP POST /api/v1/recipe
1. cURL Terminal
curl -X POST "https://www.dietspremium.com/api/v1/recipe" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "keto salmon salad",
  "locale": "en",
  "ai": true
}'
2. JavaScript / TypeScript (fetch)
const response = await fetch("https://www.dietspremium.com/api/v1/recipe", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "query": "keto salmon salad",
  "locale": "en",
  "ai": true
})
});
const data = await response.json();
console.log(data);
3. Python (requests)
import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
  "query": "keto salmon salad",
  "locale": "en",
  "ai": true
}

response = requests.post("https://www.dietspremium.com/api/v1/recipe", json=payload, headers=headers)
print(response.json())
4. PHP (Symfony HttpClient / Guzzle)
$response = $httpClient->request('POST', 'https://www.dietspremium.com/api/v1/recipe', [
    'auth_bearer' => 'YOUR_API_KEY',
    'json' => {
  "query": "keto salmon salad",
  "locale": "en",
  "ai": true
},
]);
$data = $response->toArray();

Sample Request Payload

{
  "query": "keto salmon salad",
  "locale": "en",
  "ai": true
}

Sample Response (200 OK)

200 OK
{
  "items": [
    {"id": 55, "title": "Avocado Salmon Keto Bowl", "kcal": 480, "proteins": 38.0, "fats": 32.0, "carbs": 8.0}
  ],
  "total": 1
}

Explore All REST Endpoints

Direct documentation for all available domains.

View Full API Overview
POST allergen

Allergen Search & Intolerance Detection

Access the comprehensive EU 1169/2011 allergens registry, cross-contamination warnings, and ingredient intolerance codes.

/api/v1/allergen
POST article

Article & Clinical Nutrition Guides

Search 6,000+ peer-reviewed nutrition articles, dietetic publications, and RAG grounding chapters with AI semantic vector matching.

/api/v1/article
POST company

Company & Dietetic Catering Directory

Explore 173,000+ verified dietary catering brands, clinics, fitness clubs, and health centers with geolocation metadata.

/api/v1/company
POST exercise

Exercise & Biomechanics Database

Search 2,000+ strength and cardio exercises with anatomical target muscles, required equipment, and calorie burn equations.

/api/v1/exercise
POST food

Food & Nutrient Database

High-speed search across 1,900+ foods with complete macronutrients, calorie filters, micronutrients, and allergen exclusions.

/api/v1/food
POST medication

Medication & Food-Drug Interactions

Database of 53,000+ pharmaceutical substances evaluating critical food-drug interactions, absorption interference, and nutrient depletion.

/api/v1/medication
POST recipe

Recipe & Culinary Meal Database

Access 780+ chef-crafted culinary recipes with portion weights, preparation steps, and balanced macronutrient distribution.

/api/v1/recipe
POST specialist

Specialist & Certified Dietitian Directory

Search verified clinical nutritionists, dietitians, and personal trainers with client booking and certification data.

/api/v1/user
POST supplement

Supplement & Active Substance Database

Comprehensive dietary supplement catalog with ingredient dosages, vitamin forms, and safety recommendations.

/api/v1/supplement
POST diet

Clinical & Lifestyle Diet Templates (158 Types)

Official nutritionist-designed diet templates with multi-currency pricing, day duration (3-28 days), macro splits, and allergen avoidance.

/api/v1/diet
POST food-world

Global Food Products & Barcodes (Open Food Facts + USDA)

Search 3.5M+ global branded products, EAN/UPC barcodes, brands, Nutri-Score, Eco-Score, and international ingredients.

/api/v1/food-world

Share