D
Produktions-REST-API • Höchste Performance OpenAPI 3.0

REST-API Entwickler-Integration

Hochleistungsfähiger programmatischer Direktzugriff auf über 1.900 Lebensmittel, 780 Rezepte, 53.000 Wirkstoffe und 2.000 Übungen.

Search Domains
9
Average Latency
< 15ms
Engine
Semantic Search
Locales
9 Languages
1

Schritt 1: Implementierung, Registrierung & API-Schlüssel

Starten Sie die Diets Premium API-Integration in wenigen Schritten. Generieren Sie Zugangsdaten in Ihrem Entwicklerkonto oder testen Sie den kostenlosen Tier.

Kostenloser Entwickler-Tier

Kostenloses Entwickler-Kontingent verfügbar (100 Anfragen/Tag). Registrierte Konten erhalten automatisch +100 Bonus-Anfragen/Tag.

API-Schlüssel-Authentifizierung

Authentifizierte Benutzer generieren persönliche Bearer-Tokens mit vollem Zugriff auf semantische Intelligente Suche und erweiterte Nährstofffilter.

Sicherheit & Geheimnisse

Speichern Sie API-Anmeldedaten ausschließlich auf Ihrem Server in sicheren Umgebungsvariablen. Niemals in Client-Bundles veröffentlichen.

2

Schritt 2: HTTP-Client-Verbindung & Codebeispiele

Alle Anfragen an die REST-API werden per HTTP POST an dedizierte Endpunkte mit Content-Type: application/json gesendet.

Base Endpoint
https://www.dietspremium.com/api/v1
Erforderliche HTTP-Header
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json
Integration Code Examples
cURL / JavaScript / Python / PHP POST /api/v1/food
# 1. cURL Terminal Request:
curl -X POST "https://www.dietspremium.com/api/v1/food" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "salmon", "locale": "en", "max_results": 5, "ai": true}'
// 2. JavaScript / TypeScript Fetch:
const response = await fetch("https://www.dietspremium.com/api/v1/food", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    query: "chicken breast",
    locale: "en",
    proteins_min: 25,
    kcal_max: 300,
    ai: true
  })
});
const data = await response.json();
# 3. Python (requests):
import requests

headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "query": "spinach salad",
    "locale": "en",
    "food_nutrient_include": "iron",
    "max_results": 10
}
response = requests.post("https://www.dietspremium.com/api/v1/food", json=payload, headers=headers)
print(response.json())
Statuscodes & Fehlerbehandlung
Status Code Meaning Description
200 OK Success Request processed successfully. Returns result array with total count and pagination.
400 Bad Request Invalid Payload Missing required parameter or malformed JSON structure.
401 Unauthorized Invalid Token Missing or invalid Bearer API key.
429 Too Many Requests Rate Limit Exceeded Daily limit reached. Resets at midnight UTC.
3

Schritt 3: Endpunkte & Anwendungsbeispiele (Alphabetisch)

Vollständige Anfrage- und Antwortbeispiele für alle 9 Ernährungs- und Gesundheitsdomänen in alphabetischer Reihenfolge.

POST /api/v1/allergen

Allergen Search & Intolerance Detection

allergen Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Allergen name or food derivative (e.g. "peanut", "histamine", "casein")
locale string optional en Language locale (en, pl, de, fr, nl, cz, at, ch, lu)
page integer optional 1 Pagination page index
ai boolean optional true Semantic AI query matching
Request JSON Payload 
{
  "query": "gluten",
  "locale": "en",
  "page": 1
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 1, "name": "Gluten-containing cereals", "code": "GLUTEN", "severity": "HIGH"}
  ],
  "total": 1,
  "page": 1
}
POST /api/v1/article

Article & Clinical Nutrition Guides

article Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Search term or medical inquiry (e.g. "insulin resistance diet")
locale string optional en Target language locale
ai boolean optional true Semantic AI search enabled
page integer optional 1 Pagination index
Request JSON Payload 
{
  "query": "insulin resistance diet",
  "locale": "en",
  "ai": true,
  "page": 1
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 412, "title": "Insulin Resistance & Low GI Diets", "slug": "insulin-resistance-diet", "readingTime": 6}
  ],
  "total": 12,
  "page": 1
}
POST /api/v1/company

Company & Dietetic Catering Directory

company Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Company name, specialty, or city (e.g. "keto catering Munich")
locale string optional en Target language locale
city string optional — City or geoname filter
Request JSON Payload 
{
  "query": "catering dietetyczny",
  "locale": "pl",
  "city": "Warszawa"
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 98, "name": "Premium Keto Catering", "city": "Warszawa", "rating": 4.9}
  ],
  "total": 1
}
POST /api/v1/exercise

Exercise & Biomechanics Database

exercise Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Exercise or muscle group (e.g. "dumbbell chest press", "quadriceps")
locale string optional en Target locale
ai boolean optional true AI semantic search
Request JSON Payload 
{
  "query": "barbell squat",
  "locale": "en",
  "ai": true
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 105, "name": "Barbell Back Squat", "muscle": "Quadriceps", "difficulty": "INTERMEDIATE"}
  ],
  "total": 1
}
POST /api/v1/food

Food & Nutrient Database

food Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Food item or ingredient (e.g. "grilled chicken breast", "avocado")
locale string optional en Language locale
kcal_min / kcal_max integer optional 0 Calorie thresholds per 100g
proteins_min integer optional 0 Minimum protein content in grams
allergen_exclude string optional — Comma-separated allergens to exclude
food_nutrient_include string optional — Include specific micronutrient (e.g. "iron", "calcium")
ai boolean optional true AI semantic search
Request JSON Payload 
{
  "query": "chicken breast",
  "locale": "en",
  "proteins_min": 25,
  "kcal_max": 250,
  "allergen_exclude": "gluten,lactose",
  "ai": true
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 12, "name": "Chicken Breast Raw", "kcal": 165, "proteins": 31.0, "fats": 3.6, "carbs": 0.0}
  ],
  "total": 1
}
POST /api/v1/medication

Medication & Food-Drug Interactions

medication Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Pharmaceutical compound or brand name (e.g. "Levothyroxine", "Metformin")
locale string optional en Target locale
Request JSON Payload 
{
  "query": "Levothyroxine",
  "locale": "en"
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 782, "name": "Levothyroxine Sodium", "interactions": ["Avoid calcium supplements within 4h", "Avoid coffee within 30m"]}
  ],
  "total": 1
}
POST /api/v1/recipe

Recipe & Culinary Meal Database

recipe Documentation & Live Examples

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

Request Parameters
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
Request JSON Payload 
{
  "query": "keto salmon salad",
  "locale": "en",
  "ai": true
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 55, "title": "Avocado Salmon Keto Bowl", "kcal": 480, "proteins": 38.0, "fats": 32.0, "carbs": 8.0}
  ],
  "total": 1
}
POST /api/v1/user

Specialist & Certified Dietitian Directory

specialist Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Specialist specialty, city, or name (e.g. "clinical sports dietitian")
locale string optional en Target locale
Request JSON Payload 
{
  "query": "dietetyk kliniczny",
  "locale": "pl"
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 14, "name": "dr Anna Nowak", "title": "Dietetyk Kliniczny", "verified": true}
  ],
  "total": 1
}
POST /api/v1/supplement

Supplement & Active Substance Database

supplement Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string required — Supplement or active ingredient (e.g. "Omega 3 EPA DHA", "Creatine Monohydrate")
locale string optional en Target locale
Request JSON Payload 
{
  "query": "Creatine Monohydrate",
  "locale": "en"
}
Response JSON (200 OK) application/json 
{
  "items": [
    {"id": 302, "name": "Creatine Monohydrate Creapure", "category": "Amino Acids", "standardDose": "5g/day"}
  ],
  "total": 1
}
POST /api/v1/diet

Clinical & Lifestyle Diet Templates (158 Types)

diet Documentation & Live Examples

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

Request Parameters
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
Request JSON Payload 
{
  "diet_template_type": "keto",
  "days": 28,
  "avoid_allergens": ["milk"],
  "currency": "ALL",
  "locale": "pl"
}
Response JSON (200 OK) application/json 
{
  "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
}
POST /api/v1/food-world

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

food-world Documentation & Live Examples

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

Request Parameters
Parameter Type Status Default Description
query string optional — Product name or keywords (e.g. "Coca-Cola Zero", "Nutella")
barcode string optional — EAN-13 or UPC barcode string (e.g. "5449000000996")
brand string optional — Manufacturer / brand name (e.g. "Barilla", "Nestle")
locale string optional en Target language locale
currency string optional locale default Currency for pricing (EUR, PLN, USD, ALL)
page integer optional 1 Pagination page index
Request JSON Payload 
{
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL"
}
Response JSON (200 OK) application/json 
{
  "items": [
    {
      "id": 104291,
      "name": "Spaghetti n.5",
      "brand": "Barilla",
      "barcode": "8076809513753",
      "nutriscore_grade": "a",
      "ecoscore_grade": "b",
      "kcal": 359,
      "proteins": 12.5,
      "fats": 2.0,
      "carbs": 70.9,
      "has_price": true,
      "price": {
        "amount": 1.49,
        "currency": "EUR"
      }
    }
  ],
  "total": 1,
  "page": 1
}
OpenAPI 3.0 Interactive Tester

Vollständige OpenAPI 3.0 Spezifikation (Nelmio Bundle)

Unsere interaktive OpenAPI 3.0 Spezifikation (Nelmio API Doc) bietet 100% Parameterschemata, Antwortmodelle und Live-Tests im Browser.

Interaktives Swagger UI öffnen

Teilen