Baza Szablonów Diet i Kalkulator Cen - API | Diets Premium
D
Produkcyjne REST API • Wysoka Wydajność POST /api/v1/diet 158 Clinical Types

Clinical & Lifestyle Diet Templates (158 Types)

Search verified clinical and lifestyle diet templates authored by official nutritionists. Filter by 158 specialized diet types (keto, hashimoto, low-FODMAP, vegan, etc.), duration in days (3, 7, 14, 21, 28), calorie ranges, and exclude allergens with avoid_allergens.

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/diet
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 optional — Search keyword or condition (e.g. "keto", "cukrzyca")
diet_template_type string|int optional — Diet template type ID, find code, or localized name (e.g. "keto", "hashimoto", 4)
days integer optional — Duration in days (e.g. 7, 14, 21, 28)
avoid_allergens array optional [] Allergen find codes to strictly exclude (e.g. ["milk", "nuts"])
kcal_min / kcal_max integer optional 0 Daily calorie bounds
currency string optional locale default Currency for pricing (PLN, EUR, USD, ALL)
locale string optional en Language locale (en, pl, de, etc.)
page integer optional 1 Pagination page index

Integration Code Examples

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

cURL / JavaScript / Python / PHP POST /api/v1/diet
1. cURL Terminal 
curl -X POST "https://www.dietspremium.com/api/v1/diet" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl"
}'
2. JavaScript / TypeScript (fetch) 
const response = await fetch("https://www.dietspremium.com/api/v1/diet", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl"
})
});
const data = await response.json();
console.log(data);
3. Python (requests) 
import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl"
}

response = requests.post("https://www.dietspremium.com/api/v1/diet", json=payload, headers=headers)
print(response.json())
4. PHP (Symfony HttpClient / Guzzle) 
$response = $httpClient->request('POST', 'https://www.dietspremium.com/api/v1/diet', [
    'auth_bearer' => 'YOUR_API_KEY',
    'json' => {
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl"
},
]);
$data = $response->toArray();

Sample Request Payload

{
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl"
}

Sample Response (200 OK)

200 OK 
{
  "items": [
    {
      "id": 16,
      "name": "Shape & Power 1800 kcal",
      "days_count": 28,
      "has_price": true,
      "store": [
        {"name": "Lidl"}
      ],
      "price": {
        "cost_per_day": 20.12,
        "total_cost": 563.40,
        "currency": "PLN",
        "weekly_breakdown": {
          "week_1": 164.32,
          "week_2": 125.46,
          "week_3": 129.41,
          "week_4": 144.21
        }
      }
    }
  ],
  "total": 1,
  "page": 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

Udostępnij