Analyse Nutrition
curl --request POST \
  --url https://app-api.spikeapi.com/v3/nutrition_records \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "analysis_mode": "precise",
  "body": "<string>",
  "country_code": "us",
  "ignore_cache": false,
  "include_dish_description": true,
  "include_ingredients": true,
  "include_nutri_score": false,
  "include_nutrition_fields": [
    "carbohydrate_g",
    "energy_kcal",
    "fat_total_g",
    "protein_g"
  ],
  "language_code": "de",
  "wait_on_process": false
}'
{
  "dish_description": "beef, ground, lean, cooked with broccoli, raw and rice, brown, cooked",
  "dish_description_translated": "Rindfleisch, Hackfleisch, mager, gekocht mit Brokkoli, roh und Reis, braun, gekocht",
  "dish_name": "beef and broccoli stir-fry",
  "dish_name_translated": "Rindfleisch und Brokkoli Pfanne",
  "failure_reason": "Unable to identify food items",
  "ingredients": [
    {
      "name": "beef, ground, lean, cooked",
      "name_translated": "Rindfleisch, Hackfleisch, mager, gekocht",
      "nutritional_fields": {
        "calcium_mg": 1000,
        "carbohydrate_g": 250,
        "cholesterol_mg": 300,
        "energy_kcal": 800,
        "fat_monounsaturated_g": 20,
        "fat_polyunsaturated_g": 15,
        "fat_saturated_g": 20,
        "fat_total_g": 65,
        "fat_trans_g": 0.5,
        "fiber_total_dietary_g": 25,
        "folate_mcg": 400,
        "iron_mg": 18,
        "magnesium_mg": 400,
        "niacin_mg": 16,
        "phosphorus_mg": 700,
        "potassium_mg": 3500,
        "protein_g": 50,
        "riboflavin_mg": 1.3,
        "sodium_mg": 2300,
        "sugars_total_g": 50,
        "thiamin_mg": 1.2,
        "vitamin_a_rae_mcg": 900,
        "vitamin_b12_mcg": 2.4,
        "vitamin_b6_mg": 1.7,
        "vitamin_c_mg": 90,
        "vitamin_d_mcg": 20,
        "vitamin_e_mg": 15,
        "vitamin_k_mcg": 120,
        "zinc_mg": 11
      },
      "serving_size": 120,
      "unit": "g"
    }
  ],
  "modified_at": "2025-09-15T10:30:12.132Z",
  "nutri_score": "B",
  "nutritional_fields": {
    "calcium_mg": 1000,
    "carbohydrate_g": 250,
    "cholesterol_mg": 300,
    "energy_kcal": 800,
    "fat_monounsaturated_g": 20,
    "fat_polyunsaturated_g": 15,
    "fat_saturated_g": 20,
    "fat_total_g": 65,
    "fat_trans_g": 0.5,
    "fiber_total_dietary_g": 25,
    "folate_mcg": 400,
    "iron_mg": 18,
    "magnesium_mg": 400,
    "niacin_mg": 16,
    "phosphorus_mg": 700,
    "potassium_mg": 3500,
    "protein_g": 50,
    "riboflavin_mg": 1.3,
    "sodium_mg": 2300,
    "sugars_total_g": 50,
    "thiamin_mg": 1.2,
    "vitamin_a_rae_mcg": 900,
    "vitamin_b12_mcg": 2.4,
    "vitamin_b6_mg": 1.7,
    "vitamin_c_mg": 90,
    "vitamin_d_mcg": 20,
    "vitamin_e_mg": 15,
    "vitamin_k_mcg": 120,
    "zinc_mg": 11
  },
  "record_id": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "serving_size": 120,
  "status": "completed",
  "unit": "g",
  "uploaded_at": "2025-09-15T10:30:04.521Z"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

raw body

​
body
string
required

Base64 encoded binary data

​
analysis_mode
enum<string>
default:precise

A preferred mode for the analysis

Available options:
fast,
precise
​
country_code
enum<string>
default:us

Country ISO 3166-1 alpha-2 code in lowercase

Available options:
af,
al,
dz,
ad,
ao,
ag,
ar,
am,
au,
at,
az,
bs,
bh,
bd,
bb,
by,
be,
bz,
bj,
bt,
bo,
ba,
bw,
br,
bn,
bg,
bf,
bi,
cv,
kh,
cm,
ca,
cf,
td,
cl,
cn,
co,
km,
cg,
cd,
cr,
ci,
hr,
cu,
cy,
cz,
dk,
dj,
dm,
do,
ec,
eg,
sv,
gq,
er,
ee,
sz,
et,
fj,
fi,
fr,
ga,
gm,
ge,
de,
gh,
gr,
gd,
gt,
gn,
gw,
gy,
ht,
hn,
hu,
is,
in,
id,
ir,
iq,
ie,
il,
it,
jm,
jp,
jo,
kz,
ke,
ki,
kp,
kr,
kw,
kg,
la,
lv,
lb,
ls,
lr,
ly,
li,
lt,
lu,
mg,
mw,
my,
mv,
ml,
mt,
mh,
mr,
mu,
mx,
fm,
md,
mc,
mn,
me,
ma,
mz,
mm,
na,
nr,
np,
nl,
nz,
ni,
ne,
ng,
mk,
no,
om,
pk,
pw,
pa,
pg,
py,
pe,
ph,
pl,
pt,
qa,
ro,
ru,
rw,
kn,
lc,
vc,
ws,
sm,
st,
sa,
sn,
rs,
sc,
sl,
sg,
sk,
si,
sb,
so,
za,
ss,
es,
lk,
sd,
sr,
se,
ch,
sy,
tj,
tz,
th,
tl,
tg,
to,
tt,
tn,
tr,
tm,
tv,
ug,
ua,
ae,
gb,
us,
uy,
uz,
vu,
ve,
vn,
ye,
zm,
zw
​
ignore_cache
boolean
default:false

If true, the API will not check if the exact record already exists in the cache

​
include_dish_description
boolean
default:false

Include dish description of the food

Examples:

true

​
include_ingredients
boolean
default:false

Include ingredients of the food

Examples:

true

​
include_nutri_score
boolean
default:false

Include nutri-score label of the food

​
include_nutrition_fields
enum<string>[]

Include specific nutrition fields in the analysis report. By default, carbohydrate_g, energy_kcal, fat_total_g and protein_g will be included

​
language_code
enum<string>
default:en

Language ISO 639-1 code in lowercase

Available options:
aa,
ab,
ae,
af,
ak,
am,
an,
ar,
as,
av,
ay,
az,
ba,
be,
bg,
bh,
bi,
bm,
bn,
bo,
br,
bs,
ca,
ce,
ch,
co,
cr,
cs,
cu,
cv,
cy,
da,
de,
dv,
dz,
ee,
el,
en,
eo,
es,
et,
eu,
fa,
ff,
fi,
fj,
fo,
fr,
fy,
ga,
gd,
gl,
gn,
gu,
gv,
ha,
he,
hi,
ho,
hr,
ht,
hu,
hy,
hz,
ia,
id,
ie,
ig,
ii,
ik,
io,
is,
it,
iu,
ja,
jv,
ka,
kg,
ki,
kj,
kk,
kl,
km,
kn,
ko,
kr,
ks,
ku,
kv,
kw,
ky,
la,
lb,
lg,
li,
ln,
lo,
lt,
lu,
lv,
mg,
mh,
mi,
mk,
ml,
mn,
mr,
ms,
mt,
my,
na,
nb,
nd,
ne,
ng,
nl,
nn,
no,
nr,
nv,
ny,
oc,
oj,
om,
or,
os,
pa,
pi,
pl,
ps,
pt,
qu,
rm,
rn,
ro,
ru,
rw,
sa,
sc,
sd,
se,
sg,
si,
sk,
sl,
sm,
sn,
so,
sq,
sr,
ss,
st,
su,
sv,
sw,
ta,
te,
tg,
th,
ti,
tk,
tl,
tn,
to,
tr,
ts,
tt,
tw,
ty,
ug,
uk,
ur,
uz,
ve,
vi,
vo,
wa,
wo,
xh,
yi,
yo,
za,
zh,
zu
Examples:

"de"

​
wait_on_process
boolean
default:false

If true, waits for the process to complete. If false, returns immediate response and sends notification with analysis report to webhook URL when finished

Response

OK

​
modified_at
string<date-time>
required

Update timestamp

Examples:

"2025-09-15T10:30:12.132Z"

​
record_id
string<uuid>
required

Report record ID

Examples:

"6ba7b810-9dad-11d1-80b4-00c04fd430c8"

​
status
enum<string>
required

Processing status

Available options:
pending,
processing,
completed,
failed
Examples:

"completed"

​
uploaded_at
string<date-time>
required

Upload timestamp

Examples:

"2025-09-15T10:30:04.521Z"

​
dish_description
string

Detected dish description

Examples:

"beef, ground, lean, cooked with broccoli, raw and rice, brown, cooked"

​
dish_description_translated
string

Dish description translated to target language

Examples:

"Rindfleisch, Hackfleisch, mager, gekocht mit Brokkoli, roh und Reis, braun, gekocht"

​
dish_name
string

Detected dish name

Examples:

"beef and broccoli stir-fry"

​
dish_name_translated
string

Dish name translated to target language

Examples:

"Rindfleisch und Brokkoli Pfanne"

​
failure_reason
string

Reason for processing failure

Examples:

"Unable to identify food items"

​
ingredients
object[] | null

List of detected ingredients with nutritional information

​
nutri_score
string

Nutri-Score known as the 5-Colour Nutrition label (A-E)

Examples:

"B"

​
nutritional_fields
object

Nutritional values per 100 g/ml

​
serving_size
number

Serving size in metric units

Examples:

120

​
unit
enum<string>

Metric unit (g for solids, ml for liquids)

Available options:
g,
mg,
mcg,
ml,
kcal
Examples:

"g"