Search for Food

GET

/search

Searches for food items based on a query string with pagination support and optional type filtering. Nutrient units are fixed per nutrient. See unit reference: https://newtrition-data.com/data-reference/units/

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

query

required

string

Search query for food name

type

string

Allowed values: all generic branded

Filter by food type (all, generic, branded). Default: all

limit

integer

Number of items per page (1-100, default: 10)

offset

integer

Number of items to skip (default: 0)

page

integer

Page number (alternative to offset)

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

Paginated list of matching food items

object

data

Array<object>

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

links

object

first

string

last

string

next

string

previous

string

self

string

pagination

object

has_next

boolean

has_previous

boolean

limit

integer

offset

integer

page

integer

total_count

integer

total_pages

integer

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 query parameter, invalid pagination parameters, or invalid type filter

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