Search for Food by GTIN

GET

/search/gtin

Searches for a singular food item based on a gtin string. Nutrient units are fixed per nutrient. See unit reference: https://newtrition-data.com/data-reference/units/

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

gtin

required

string

Gtin number for the food item search

Header Parameters

X-Context-ID

string

Context ID of the end user (used for analytics and weighting). If not provided, defaults to client ID.

Responses

200

Matching food item

object

data

object

brand

string

gtin

string

is_solid

boolean

name

string

processed_variants

Array<object>

object

big7

object

carbohydrates

object

amount

number

Example

225.5

label

string

Example

Proteine

unit

The output units are fixed per nutrient/output! See: https://newtrition-data.com/data-reference/units/

string

Allowed values: µg mg g kg kJ ml l kJ/g kcal/g

Example

g

energy

object

amount

number

Example

225.5

label

string

Example

Proteine

unit

The output units are fixed per nutrient/output! See: https://newtrition-data.com/data-reference/units/

string

Allowed values: µg mg g kg kJ ml l kJ/g kcal/g

Example

g

fat

object

amount

number

Example

225.5

label

string

Example

Proteine

unit

The output units are fixed per nutrient/output! See: https://newtrition-data.com/data-reference/units/

string

Allowed values: µg mg g kg kJ ml l kJ/g kcal/g

Example

g

protein

object

amount

number

Example

225.5

label

string

Example

Proteine

unit

The output units are fixed per nutrient/output! See: https://newtrition-data.com/data-reference/units/

string

Allowed values: µg mg g kg kJ ml l kJ/g kcal/g

Example

g

salt

object

amount

number

Example

225.5

label

string

Example

Proteine

unit

The output units are fixed per nutrient/output! See: https://newtrition-data.com/data-reference/units/

string

Allowed values: µg mg g kg kJ ml l kJ/g kcal/g

Example

g

saturated_fatty_acids

object

amount

number

Example

225.5

label

string

Example

Proteine

unit

The output units are fixed per nutrient/output! See: https://newtrition-data.com/data-reference/units/

string

Allowed values: µg mg g kg kJ ml l kJ/g kcal/g

Example

g

sugar

object

amount

number

Example

225.5

label

string

Example

Proteine

unit

The output units are fixed per nutrient/output! See: https://newtrition-data.com/data-reference/units/

string

Allowed values: µg mg g kg kJ ml l kJ/g kcal/g

Example

g

id

string

label

string

processing

string

Allowed values: raw baked boiled braised broiled deep-fried dried fried roasted steamed stewed

search_weight

number

serving_sizes

Array<object>

object

amount

number

Example

120

label

string

Example

Stück

type

string

Allowed values: package portion small_piece medium_piece large_piece small_slice medium_slice large_slice small_whole medium_whole large_whole small_bottle medium_bottle large_bottle small_glass medium_glass large_glass small_cup medium_cup large_cup small_bowl medium_bowl large_bowl pinch tablespoon teaspoon small_toe medium_toe large_toe

Example

piece

unit

string

Allowed values: g ml

Example

g

type

string

Allowed values: generic_single_food generic_composite_food branded_food

Headers

X-RateLimit-Limit

integer

Maximum requests per minute

X-RateLimit-Remaining

integer

Requests remaining in current window

X-RateLimit-Reset

integer

Unix timestamp when rate limit resets

X-RateLimit-Used

integer

Requests used in current window

400

Missing gtin query parameter, invalid gtin format

object

error

object

code

string

details

message

string

401

Unauthorized

object

error

object

code

string

details

message

string

429

Rate limit exceeded

object

error

object

code

string

details

message

string

Headers

X-RateLimit-Limit

integer

Maximum requests per minute

X-RateLimit-Remaining

integer

Requests remaining in current window

X-RateLimit-Reset

integer

Unix timestamp when rate limit resets

X-RateLimit-Used

integer

Requests used in current window

X-Retry-After

integer

Seconds to wait before retrying

500

Internal Server Error

object

error

object

code

string

details

message

string