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

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

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

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

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

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

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

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

processing

string

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

quantity_unit

string

quantity_value

number

search_weight

number

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