API RESTOWE | Diets Premium
D
Produkcyjne REST API • Wysoka Wydajność OpenAPI 3.0

Integracja Programistyczna REST API

Bezpośredni, wysokowydajny dostęp programistyczny do bazy ponad 1 900 produktów spożywczych, 780 przepisów, 53 000 substancji leczniczych i 2 000 ćwiczeń.

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

Krok 1: Wdrożenie, Rejestracja i Klucze API

Rozpocznij integrację z API Diets Premium w kilku prostych krokach. Wygeneruj klucz w panelu użytkownika lub przetestuj publiczny pakiet deweloperski.

Pakiet Darmowy (Free Tier)

Dostępny darmowy pakiet deweloperski 100 req/dzień. Zalogowane konta otrzymują automatycznie bonus +100 zapytań/dzień.

Autoryzacja Kluczem API

Zalogowani użytkownicy generują indywidualne klucze Bearer z pełnym dostępem do wyszukiwania semantycznego i zaawansowanych filtrów.

Bezpieczeństwo i Sekrety

Klucze API przechowuj wyłącznie na serwerze w bezpiecznych zmiennych środowiskowych. Nigdy nie udostępniaj ich publicznie.

2

Krok 2: Połączenie Klienta HTTP i Przykłady Kodu

Wszystkie zapytania do REST API są realizowane metodą POST na dedykowane punkty końcowe z nagłówkiem Content-Type: application/json.

Base Endpoint
https://www.dietspremium.com/api/v1
Wymagane Nagłówki HTTP
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())
Kody Odpowiedzi i Obsługa Błędów
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

Krok 3: Punkty Końcowe i Przykłady Użycia (Alfabetycznie)

Kompletne przykłady zapytań i odpowiedzi dla 9 domen żywieniowo-medycznych, uszeregowanych alfabetycznie.

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

Pełna Specyfikacja OpenAPI 3.0 (Nelmio Bundle)

Interaktywny interfejs OpenAPI 3.0 (Nelmio API Doc) zawiera 100% schematów parametrów, definicji typów oraz interaktywną konsolę testową.

Otwórz Pełną Dokumentację Swagger UI

Udostępnij