# FitVete Food & Nutrition API

> A curated, confidence-scored REST API for food, recipe, drink, and full micronutrient data — plus barcode lookup, AI meal-photo analysis, Nutrition Facts label parsing, natural-language meal parsing, personalized A–F health scoring, and healthier-swap suggestions. Built for nutrition, fitness, diet, calorie-tracking, and recipe apps — and easy for AI agents to call. Free tier, no card required.

- Base URL: `https://auth.fitvete.com/functions/v1/food-api`
- Auth: send your key in the `x-api-key` header (or `?apiKey=`). Get a free key at https://fitvete.com/api/.
- Format: JSON over HTTPS. Metered by daily points — most endpoints cost 1 point; AI endpoints cost 2–10. Every response returns `X-RateLimit-*` headers.
- Quick test: `curl "https://auth.fitvete.com/functions/v1/food-api/v1/search-foods?query=chicken" -H "x-api-key: fv_live_your_key"`

## Docs
- [API overview & pricing](https://fitvete.com/api/): what it does, plans, quick start.
- [Full developer docs](https://fitvete.com/api/docs): authentication, every endpoint, errors, rate limits, and copy-paste code samples in cURL, JavaScript, Python, PHP, Ruby, Go, Java, C#, and Swift, plus a zero-dependency CLI built for AI agents.
- [OpenAPI 3.1 spec](https://fitvete.com/api/openapi.yaml): machine-readable — import into any client, SDK generator, or agent tool.
- [Live playground](https://fitvete.com/api/playground): run real API calls in the browser, no signup.
- [Detailed LLM guide](https://fitvete.com/llms-full.txt): every endpoint with parameters, point costs, and example responses.
- CLI (npm): `npm install -g fitvete-food-cli` — zero-dependency, prints clean JSON for agents. https://www.npmjs.com/package/fitvete-food-cli

## Endpoints
- `GET /v1/search-foods?query=` — search foods; calories, macros, and a confidence score (1 pt).
- `GET /v1/foods/autocomplete?query=` — food-name typeahead (1 pt).
- `GET /v1/compute-nutrition?ingredients=` — full macros + 25+ micronutrients for a free-text ingredient list (1 pt).
- `GET /v1/barcode/{code}` — UPC/EAN packaged-food lookup with brand, image, and nutrition (1 pt).
- `GET /v1/recipes/search?query=` — recipe search with diet, cuisine, intolerance, ingredient, and nutrient filters (1 pt).
- `GET /v1/recipes/{id}` — full recipe: ingredients with measures, steps, nutrition, optional servings scaler (1 pt).
- `GET /v1/recipes/{random,autocomplete,by-nutrients,{id}/similar,diets,meal-types,cuisines}` — recipe utilities (1 pt).
- `GET /v1/drinks/search?query=` — drinks & cocktails with flavors, glass, ingredients, nutrition (1 pt).
- `POST /v1/parse` — turn a plain-English meal into structured items with per-item and total nutrition (5 pts).
- `POST /v1/score` — deterministic 0–100 health score + A–F grade for a food, personalized to goals/diet/allergies (3 pts).
- `GET /v1/alternatives?name=` — ranked healthier swaps for a food (1 pt).
- `POST /v1/analyze-ingredients` — additives/E-numbers, allergens, NOVA ultra-processing level, and vegan/vegetarian/gluten-free flags (2 pts).
- `POST /v1/nutrition-from-photo` — AI vision estimates a meal's nutrition from a photo (10 pts).
- `POST /v1/nutrition-label` — AI vision parses a Nutrition Facts label photo into structured fields (10 pts).

## Pricing
- Free — $0/mo, 50 points/day, all endpoints, no card.
- Starter — $19/mo, 1,000 points/day.
- Pro — $99/mo, 10,000 points/day.
- Ultra — $399/mo, 100,000 points/day. Volume/custom: api@fitvete.com.

## Get started
- [Create a free API key](https://fitvete.com/api/login): email sign-up, key in seconds, no card.
- Support: api@fitvete.com