Globalna Baza Produktów i Kodów Kreskowych - API | Diets Premium
D
Produkcyjne REST API • Wysoka Wydajność POST /api/v1/food-world Global Barcode DB

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

Comprehensive global food catalog integrating Open Food Facts and USDA FoodData Central. Query products by commercial barcode (EAN-13, UPC), manufacturer brand, localized product title, categories, and country of origin with multi-currency pricing.

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/food-world
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 — 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

Integration Code Examples

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

cURL / JavaScript / Python / PHP POST /api/v1/food-world
1. cURL Terminal 
curl -X POST "https://www.dietspremium.com/api/v1/food-world" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL"
}'
2. JavaScript / TypeScript (fetch) 
const response = await fetch("https://www.dietspremium.com/api/v1/food-world", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL"
})
});
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": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL"
}

response = requests.post("https://www.dietspremium.com/api/v1/food-world", json=payload, headers=headers)
print(response.json())
4. PHP (Symfony HttpClient / Guzzle) 
$response = $httpClient->request('POST', 'https://www.dietspremium.com/api/v1/food-world', [
    'auth_bearer' => 'YOUR_API_KEY',
    'json' => {
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL"
},
]);
$data = $response->toArray();

Sample Request Payload

{
  "query": "barilla spaghetti",
  "brand": "Barilla",
  "locale": "pl",
  "currency": "ALL"
}

Sample Response (200 OK)

200 OK 
{
  "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
}

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