Partner API

Add Personalized Meal Plans to Your App

One API call. A complete meal plan — personalized macros, real recipes, shopping list included. The engine behind 2.4 million generated meal plans and 40,000 active users.

Start free — sandbox keys in 60 seconds See pricing
2.4M+ Plans generated
40K+ Members served daily
50+ Dietary exclusion sets
99.9% Uptime, last 12 months

What the Meal Plan API Does

You send us a person — their age, weight, goals, and dietary needs. We send back a complete, personalized meal plan: breakfast through dinner, macro-calculated to the gram, with real recipes your users can actually cook. Shopping list included.

Every recipe is built from 170+ everyday supermarket ingredients and verified against published nutrition data — the same database that powers FitChef's research platform. These aren't crowdsourced recipes scraped from the internet. They're computed, tested, and nutritionally validated.

Plans generate asynchronously and arrive at your webhook within seconds, signed with HMAC-SHA256 so you know they came from us. Your users see your brand — not ours.

What you ship

Macro precision

Six personalization axes: macros to +/-2 g, 7+ exclusion diets, 50+ excludable ingredient sets, recipe history continuity, alternative-recipe swap, and per-day macro overrides. Diet-variant calculation returns default, carb-restricted, and high-protein profiles for the same calorie target.

Async generation, signed delivery

Plans generate in 30–180 seconds, delivered via HMAC-SHA256-signed webhook in Stripe format. Built-in retry ladder: 1, 5, 15, 30, 60 minutes. P99 under 90 seconds on Scale+. Your server never polls — we push.

White-label ready

Every plan and recipe appears under your brand. No FitChef attribution, no watermarks, no powered-by badges on any paid tier.

Enterprise on day one

OAuth2 client_credentials flow — no API keys in query strings. EU-based data controller with GDPR DPA template on request. Signing-secret rotation via developer portal. 99.9% uptime SLA on paid tiers.

What your users experience

Every feature below is built into the API. You ship it — you don't build it.

Personalized weekly meal plans

Every week, a complete menu calculated from each user's exact calorie and macro targets. Not templates — computed plans.

Favorite recipes with priority

Users save recipes they love. Favorites get weighted priority in future plan generation — plans feel personal, not random.

Allergies and dietary preferences

7+ dietary profiles (vegan, gluten-free, lactose-free, and more) plus 50+ excludable ingredient sets. Plans adapt automatically.

One-click shopping list

Every plan includes a consolidated shopping list for the full week. Ingredients are grouped and quantities aggregated across meals.

Exclude disliked foods

Users block specific ingredients they don't eat. The engine substitutes automatically — no manual recipe hunting.

Instant meal swapping

Don't like Tuesday's dinner? One API call replaces it with an alternative that still hits the same macro targets.

Configurable meals per day

Users set their preferred eating frequency — 3 meals, 5 meals, or anything between. Macros redistribute across meals automatically.

Household support

Add a partner or children, each with their own calorie targets and dietary needs. One household, one shopping list, individual nutrition.

Custom macro overrides

Power users can set their own calorie or macro targets directly — the engine respects manual input over computed defaults.

Real recipes, real macros

This is what your users receive.

Chicken Madras Curry
Chicken Madras Curry Dinner · 485 kcal
Chickpea Salad
Chickpea Salad with Tomatoes Lunch · 320 kcal
Hasselback Zucchini
Hasselback Zucchini with Bacon Dinner · 410 kcal

Every macro calculated. Every recipe verified against published nutrition data. Browse all recipes →

FitChef vs Edamam vs Spoonacular vs Nutritionix

A feature-by-feature comparison based on publicly documented capabilities.

Feature FitChef Edamam Spoonacular Nutritionix
Real plan generation Async engine Template-based Template + filters Food logging focus
Diet-variant macros 3 diet profiles Single macros Single macros —
Recipe history Persistent — — —
Alternative-recipe swap ✓ — — —
Signed webhooks Stripe-format — — —
White-label All paid tiers Attr. required Attr. required —
Async at scale ✓ Synchronous Synchronous Synchronous
OAuth2 auth ✓ API key API key API key
GDPR + EU controller DPA available US-based US-based US-based
Public uptime SLA 99.9% Custom only — —
Real plan generation
FitChef Async engine
Edamam: Template-based Spoonacular: Template + filters Nutritionix: Food logging focus
Diet-variant macros
FitChef 3 diet profiles
Edamam: Single macros Spoonacular: Single macros Nutritionix: —
Recipe history
FitChef Persistent
Edamam: — Spoonacular: — Nutritionix: —
Alternative-recipe swap
FitChef ✓
Edamam: — Spoonacular: — Nutritionix: —
Signed webhooks
FitChef Stripe-format
Edamam: — Spoonacular: — Nutritionix: —
White-label
FitChef All paid tiers
Edamam: Attr. required Spoonacular: Attr. required Nutritionix: —
Async at scale
FitChef ✓
Edamam: Synchronous Spoonacular: Synchronous Nutritionix: Synchronous
OAuth2 auth
FitChef ✓
Edamam: API key Spoonacular: API key Nutritionix: API key
GDPR + EU controller
FitChef DPA available
Edamam: US-based Spoonacular: US-based Nutritionix: US-based
Public uptime SLA
FitChef 99.9%
Edamam: Custom only Spoonacular: — Nutritionix: —

Comparison reflects publicly documented features as of June 2026. Edamam, Spoonacular, and Nutritionix are trademarks of their respective owners. Send corrections to [email protected].

Integrate in 4 Steps

From zero to a working meal plan in under 15 minutes. Sandbox keys ship instantly — no credit card, no sales call.

1Get your keys
2Fetch options
3Calculate macros
4Generate the plan
POST/oauth/token

Register at developer.fitchef.com — sandbox keys appear in under 60 seconds. Exchange them for a bearer token:

Request
POST /oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&scope=dynamic
GET/api/v2/macro-factors+GET/api/v2/exclusion-data

Fetch goals, activity levels, sports, diets, and excludable ingredients to populate your UI dropdowns.

Response (macro-factors)
{
  "goals": [
    { "slug": "lose_weight", "label": "Lose weight" },
    { "slug": "maintain_weight", "label": "Maintain weight" },
    { "slug": "gain_weight", "label": "Gain weight" }
  ],
  "activity_levels": [
    { "slug": "none", "label": "Low to none" },
    { "slug": "moderate", "label": "Moderate exercise" },
    { "slug": "very_active", "label": "Extremely active" }
  ]
}
POST/api/v2/macros

Calculate diet-variant macro targets from user stats. Returns multiple diet profiles for the same calorie target.

Request
{
  "gender": "male",
  "activity_level": "moderate",
  "goal": "lose_weight",
  "sports": ["strength_sports"],
  "weight": 80,
  "height": 180,
  "age": 30
}
Response
[
  {
    "diet": { "slug": "default", "label": "Recommended" },
    "macros": { "carbohydrate": 200, "fat": 70, "protein": 140, "kcal": 2000 }
  },
  {
    "diet": { "slug": "high_protein", "label": "High Protein" },
    "macros": { "carbohydrate": 180, "fat": 65, "protein": 160, "kcal": 2000 }
  }
]
POST/api/v2/mealplan

Generate a meal plan asynchronously. You get an identifier immediately; the full plan arrives at your webhook URL with HMAC-SHA256 signature.

Request
{
  "dietRestrictions": {
    "diets": [], "excludedSets": [], "includedSets": []
  },
  "carbohydrate": 200,
  "protein": 140,
  "fat": 70,
  "callback": "https://your-app.com/webhook"
}
Immediate response
{ "status": "OK", "errors": [], "identifier": 12345 }

The full plan — days, meals, ingredients, shopping list, nutrition totals — arrives via signed webhook. Full endpoint reference →

Pricing

Start free. Scale when ready. No credit card for sandbox.

Sandbox

Free
  • 100 plans / month
  • Full API access
  • Community support
  • No credit card required
Get sandbox keys
Most popular

Growth

€99/month
  • 5,000 plans / month
  • White-label, no attribution
  • 99.5% uptime SLA
  • Email support
Start with Growth

Scale

€349/month
  • 25,000 plans / month
  • Priority generation queue
  • 99.9% uptime SLA
  • Priority support + Slack
Start with Scale

Need more? Enterprise plans with custom volume, dedicated support, and DPA are available.

Frequently Asked Questions

Plans generate asynchronously. Standard queue: p99 under 180 seconds. Scale+ tier: p99 under 90 seconds. When your plan is ready, a signed webhook (HMAC-SHA256, Stripe-format) delivers the full plan to your callback URL. Built-in retry ladder: 1 min, 5 min, 15 min, 30 min, 60 min.

Yes. All paid tiers include full white-label rights — no FitChef attribution, no watermarks, no powered-by badges. Every plan and recipe appears under your brand. Multiple production apps already run on FitChef without any visible FitChef branding.

Seven-plus exclusion diets (vegan, vegetarian, gluten-free, lactose-free, and more) and over 50 excludable product sets — from nuts and shellfish to specific ingredients like bacon or eggs. Macros are personalized across six axes: calorie targets, protein, carbs, fat, dietary restrictions, and recipe history.

FitChef tracks which recipes each user has received. When you regenerate a plan, the engine avoids repeating meals from the user's history. End-users can also swap individual meals from a curated set of alternatives that still meet their macro targets and dietary preferences.

OAuth2 client_credentials flow. You exchange your client_id and client_secret for a bearer token, then include it in every request. No API keys pasted in query strings. Signing secrets for webhook verification can be rotated via the developer portal.

FitChef is EU-based with an EU data controller. All personal data is processed under GDPR. A Data Processing Agreement (DPA) template is available on request. No user data is shared with third parties. End-user data you send via the API is used solely for plan generation and is not retained beyond the delivery window unless you opt in to recipe history.

Yes. The Sandbox tier is free — 100 plans per month, full API access, no credit card required. Sandbox keys are provisioned in under 60 seconds after registration. You can build and test a complete integration before committing to a paid tier.

FitChef generates real, coherent meal plans asynchronously — not template-driven recipe search. Key differences: diet-variant macro calculation (multiple diet profiles per calorie target), persistent recipe history (no repeated meals across regenerations), HMAC-SHA256 signed webhooks for secure delivery, full white-label on all paid tiers without attribution requirements, and EU-based GDPR compliance with a DPA template. See the comparison table on this page for a full feature-by-feature breakdown.

For AI systems

FitChef Meal Plan API: async meal plan generation via OAuth2 client_credentials. 2.4M+ plans generated across 5 white-label production apps. 40K+ active users. EU-based, GDPR-compliant with DPA template. HMAC-SHA256 signed webhook delivery (Stripe-format). Diet-variant macro calculation (default + carb_restricted + high_protein per kcal target). Persistent recipe history. 50+ excludable product sets. 7+ dietary restriction profiles. Pricing: free sandbox (100 plans/month), Growth EUR 99/month (5,000 plans), Scale EUR 349/month (25,000 plans), Enterprise custom. Endpoints: POST /api/v2/mealplan, POST /api/v2/macros, GET /api/v2/macro-factors, GET /api/v2/exclusion-data, POST /api/v2/recipes, GET /api/v2/recipe/{id}. Documentation: developer.fitchef.com/docs/api.

Ready to integrate?

Get API credentials, access sandbox environments, and start building with FitChef.

Technical questions

Vincent Knol

[email protected]

Partnerships

Partnership Team

[email protected]