Nutrition Label Parse

Upload a nutrition facts label image and get structured macros back — calories, protein, carbs, fat, and key nutrients with a confidence score.

This endpoint creates a scan record you can fetch later via GET /v1/scans/<scan_id>.

Quickstart Get an API key

Endpoint

POST /v1/parse/nutrition-label

Requests are made to:

Base URL

https://api.nutritionsignals.com

Authentication

All requests require an API key sent as a Bearer token in the Authorization header.

Authorization header

Authorization: Bearer YOUR_API_KEY

Request

Send a multipart form upload:

image — the label image file (required)
country — optional (e.g. DE, US)

cURL

curl https://api.nutritionsignals.com/v1/parse/nutrition-label \
  -H "Authorization: Bearer $NUTRITIONSIGNALS_API_KEY" \
  -F "image=@/path/to/label.jpg" \
  -F "country=DE"

Try it

POST /v1/parse/nutrition-label

API Key (Bearer)

Tip: Get a key in Authentication.

Function URL / Base URL

Calling:

https://api.nutritionsignals.com/v1/parse/nutrition-label

Country (optional)

Label image

Notes

Best results: clear, straight-on label photo with good lighting.
Response includes scan_id so you can fetch it later via GET /v1/scans/<scan_id>.

Response

{}

Response

Example response:

Example response

{
  "scan_id": "abc123",
  "kind": "nutrition_label_parse",
  "country": "DE",
  "serving": { "amount": 100, "unit": "g" },
  "calories_kcal_total": 220,
  "protein_g": 12,
  "carbs_g": 18,
  "fat_g": 11,
  "fiber_g": 2,
  "sugar_g": 6,
  "sodium_mg": 320,
  "confidence": 0.86,
  "image_url": "https://api.nutritionsignals.com/v1/images/scans/labels/....jpg",
  "image_path": "scans/labels/....jpg",
  "image_hash": "...."
}

Errors

401 — Missing/invalid API key
422 — Invalid request body / missing image
429 — Rate limited
5xx — Server error

Read Errors