API Referencev1
Base URL:https://api.chezvous.co

Chez Vous API

The Chez Vous API provides anonymised aggregate food intelligence derived from home-cooked meal data. All data is k-anonymised (k≥10) — individual-level data is never accessible.

Authentication

All data endpoints require an API key passed in the X-API-Key header.

curl https://api.chezvous.co/v1/dietary/allergens \
  -H "X-API-Key: cvk_your_key_here"

Response format

All data endpoints return a JSON envelope:

{
  "data_as_of": "2026-01-15",
  "count": 12,
  "data": [...]
}

Rate limits

free100 req/day
starter1,000 req/day
pro10,000 req/day
enterpriseUnlimited

k-Anonymity guarantee

All geographic cohorts contain at least 10 individuals. Cohorts below this threshold are suppressed. City-level granularity is additionally suppressed when cohorts are too small. No individual-level data is ever exposed.

Authentication

Dietary Insights

Cuisine & Ingredients

Occasion Patterns

Account & Keys

Python example

import httpx

API_KEY = "cvk_your_key_here"
BASE = "https://api.chezvous.co"

headers = {"X-API-Key": API_KEY}

# Allergen prevalence in France
r = httpx.get(f"{BASE}/v1/dietary/allergens", params={"country_code": "FR"}, headers=headers)
r.raise_for_status()
data = r.json()

print(f"Snapshot: {data['data_as_of']}, rows: {data['count']}")
for row in data["data"]:
    print(f"  {row['allergen_name']}: {row['prevalence_pct']:.1f}% ({row['cohort_size']} people)")