Food search
Search normalized foods and return calories, macros, micronutrients, confidence, and useful attributes.
FitVete Food & Nutrition API
Foods, recipes, drinks, barcodes, ingredient analysis, and meal-photo nutrition through a predictable REST interface. Start with a free key and ship without maintaining the data layer yourself.
GET /v1/drinks/search?query=margarita&number=1 x-api-key: fv_live_••••••••
{
"number": 1,
"source": "corpus",
"drinks": [{
"title": "Whitecap Margarita",
"images": [
"https://auth.fitvete.com/
storage/.../food-images/8de2.jpg"
],
"calories": 476
}]
}
Capabilities
A focused API surface for the data work most health, fitness, grocery, and recipe products need.
Search normalized foods and return calories, macros, micronutrients, confidence, and useful attributes.
Turn an ingredient list into structured macros, vitamins, minerals, daily values, and serving totals.
Search by name, diet, cuisine, ingredients, time, or nutrient range, then retrieve full instructions and nutrition.
Resolve UPC and EAN products into names, brands, servings, nutrition, dietary attributes, and processing signals.
Estimate a meal from a photo or convert a Nutrition Facts label into structured JSON with clear failure states.
Analyze ingredients, score foods against goals and allergies, parse meals, and suggest healthier alternatives.
Data model
FitVete checks its validated library before any fallback. Qualified misses can be normalized, scored, and retained, so repeat requests increasingly stay inside the FitVete data layer.
Exact keys, aliases, and ranked text matching resolve common foods before any fallback.
corpusUnknown queries enter a miss queue and may use a licensed or public-data source as temporary coverage.
missUnits, macros, nutrients, and confidence are shaped into one contract before promotion.
scoreApproved images are cached in FitVete Storage. Public response URLs stay on FitVete domains.
hostCorroborated records gain confidence and future consumers benefit from the stronger library.
learnEndpoint directory
Every endpoint returns JSON. Most requests cost one point; compute-heavy intelligence and vision routes declare their higher cost clearly.
/v1/search-foodsFoods, macros, confidence, attributes
→ GET/v1/compute-nutritionFull nutrition for an ingredient list
→ GET/v1/recipes/searchRecipes by query, diet, cuisine, time, nutrients
→ GET/v1/drinks/searchDrinks, measures, flavors, nutrition, images
→ GET/v1/barcode/{code}Packaged-food lookup by UPC or EAN
→ POST/v1/scoreGoal-aware A–F nutrition scoring
→ POST/v1/nutrition-from-photoMeal-photo calories, macros, and nutrients
→ POST/v1/nutrition-labelNutrition Facts image to structured JSON
→Pricing
Every plan uses the same endpoints and response contracts. Upgrade only when your product needs more daily capacity.
Free
50 points every day
Starter
1,000 points every day
Pro Popular
10,000 points every day
Ultra
100,000 points every day
Create a free key, copy a working example, and start with the full API surface.