USDA-Verified Nutrition Analysis API
for Developers
Accurate, production-ready nutrition data in clean JSON. Easy to integrate, secure, lightning-fast responses with real USDA IDs.
Quick Start:
Example Requests and Responses
Complete examples for CLI, Python SDK, and direct API calls
See exactly how to install, authenticate, and make requests with CLI, Python, or direct API calls. Select a tab to see details.
## Install
$ npm install -g avocavo-nutrition-cli
## Login
$ avocavo login
## Example Request
$ avocavo ingredient "1 cup brown rice"
## Example Response (All 29 Nutrition Fields)
â
2 cups broccoli
ðĨ Calories: 114.08
ðĨĐ Protein: 9.46g
ð§ Total Fat: 1.25g
ðū Carbohydrates: 23.07g
ðŋ Fiber: 8.83g
ð§ Sodium: 120.96mg
ðĶī Calcium: 169.28mg
ðĐļ Iron: 2.54mg
ðĨ Saturated Fat: 0.25g
ð Cholesterol: 0mg
ðŊ Sugar: 5.42g
⥠Potassium: 1141.44mg
ð Vitamin A: 2207.04 IU
ð Vitamin C: 322.56mg
ð Folate: 226.56mcg
ð USDA: Broccoli, raw (FDC ID: 747447)
ð Estimated Grams: 368g (scaled from USDA 100g)
ð Quality: excellent | Confidence: 0.95
â ïļ 14 nutrients returned as null (no USDA data)
â Supports single ingredients, batch lists, and complete recipes with serving-based nutrition.
Note: All endpoints now return all 29 nutrition fields with null transparency (null = no USDA data available, not zero).
Stop wrestling with messy nutrition parsing.
Building meal planners, recipe apps, or nutrition labeling shouldn't mean scraping, guessing, or maintaining massive databases.
Avocavo solves this:
Official USDA FoodData Central integration
Portion-aware parsing and automatic conversion
Real FDC IDs and verification URLs in every response
Clean, predictable JSON schema
Typical ~200ms response times with intelligent caching
Supports single ingredients, batch lists, and full recipes with servings
Secure OAuth login â no API key headaches
CLI, NPM, and Python packages for easy setup
How It Works
Start using verifiable nutrition data in minutes â no complicated onboarding or hidden restrictions.
Send Your Ingredient or Recipe Text
e.g. "1 cup brown rice, cooked" or a full recipe list
We Normalize & Parse
Handles messy, real-world inputs automatically
USDA Lookup with Verification
Returns real FDC IDs, USDA links, and official nutrition data
Get Clean, Structured JSON
Ready to drop directly into your app
Why Developers Choose Avocavo
âNo Usage Restrictions
- Your data. Your app. No limitations.
- Store and serve USDA-verifiable nutrition data with complete freedom
- No rate limits on stored data access
âUSDA-Verifiable Accuracy
- Official FoodData Central IDs and nutrition data
- USDA verification URLs in every response
âHandles Portion Conversion Automatically
- User input like "2 cups rice, cooked" â correct USDA match
- Accurate gram-based nutrition
âSupports Single Ingredients, Batch Lists, and Full Recipes
- Analyze one ingredient or an entire recipe
- Automatic serving calculations
âClean, Structured JSON
- No scraping
- No manual parsing
- Always consistent schema
âLightning-Fast Responses
- Typical ~200ms per request thanks to caching
- Optimized for high-volume usage
âSecure OAuth Login
- No API keys to manage or leak
- Modern authentication flow
âDeveloper-First Tooling
- CLI
- NPM package
- Python SDK
- cURL-friendly REST API
âPredictable, Affordable Pricing
- Free tier to test
- Buy extra calls anytime at $1/1,000
- Discounted monthly plans available
- No surprise overages
Simple, Transparent Pricing
â Free trial â 100 calls (one-time) to test your integration
â Pay-as-you-go credits available â $1 per 1,000 calls
â All plans include all 29 nutrition fields with USDA verification
Free Trial
Test your integration
- 100 API calls (one-time trial credit)
- Batch limit: 3 ingredients
- Full feature access
Starter
For prototypes & indie apps
- 2,500 calls/month
- Batch limit: 8 ingredients
- Pay-as-you-go credits available
Rate Limits & Burst Capacity
Designed for Production Use
Plan | Hourly Limit | Per-Minute Limit | Burst Rate |
---|---|---|---|
Free | 1,000 / hour | 100 / minute | Up to 50 requests / 10 seconds |
Starter | 2,500 / hour | 500 / minute | Up to 100 requests / 10 seconds |
Professional | 10,000 / hour | 1,000 / minute | Up to 200 requests / 10 seconds |
Business | 50,000 / hour | 5,000 / minute | Custom limits with SLAs |
â Need more? Contact us for custom enterprise plans.