Skip to content
Newtrition Data

Search for Food

GET
/search

Searches for food items based on a query string with pagination support and optional type filtering. Search results are grouped to reduce near-duplicates. For deep pagination, pagination.total_count, pagination.total_pages, and links.last should be treated as approximate navigation metadata. Prefer sequential navigation via links.next / links.previous instead of precomputing an exact final page. Nutrient units are fixed per nutrient. See unit reference: https://newtrition-data.com/data-reference/units/

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “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

Section titled “Header Parameters”
X-Context-ID
string

Optional pseudonymous end-user context ID used for analytics and weighting. Defaults to client ID and must not contain personal data.

Responses

Section titled “ Responses ”

200

Section titled “200”

Paginated list of matching food items

Media typeapplication/json
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
label
string
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
energy
object
amount
number
label
string
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
fat
object
amount
number
label
string
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
protein
object
amount
number
label
string
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
salt
object
amount
number
label
string
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
saturated_fatty_acids
object
amount
number
label
string
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
sugar
object
amount
number
label
string
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
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
label
string
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
unit
string
Allowed values: g ml
standard_processing
string
Allowed values: raw baked boiled braised broiled deep-fried dried fried roasted steamed stewed
standard_serving_type

Can be null!

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
standard_unit
string
Allowed values: g ml
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
Example
{
  "data": [
    {
      "processed_variants": [
        {
          "big7": {
            "carbohydrates": {
              "amount": 225.5,
              "label": "Proteine",
              "unit": "g"
            },
            "energy": {
              "amount": 225.5,
              "label": "Proteine",
              "unit": "g"
            },
            "fat": {
              "amount": 225.5,
              "label": "Proteine",
              "unit": "g"
            },
            "protein": {
              "amount": 225.5,
              "label": "Proteine",
              "unit": "g"
            },
            "salt": {
              "amount": 225.5,
              "label": "Proteine",
              "unit": "g"
            },
            "saturated_fatty_acids": {
              "amount": 225.5,
              "label": "Proteine",
              "unit": "g"
            },
            "sugar": {
              "amount": 225.5,
              "label": "Proteine",
              "unit": "g"
            }
          },
          "processing": "raw"
        }
      ],
      "serving_sizes": [
        {
          "amount": 120,
          "label": "Stück",
          "type": "piece",
          "unit": "g"
        }
      ],
      "standard_processing": "raw",
      "standard_serving_type": "package",
      "standard_unit": "g",
      "type": "generic_single_food"
    }
  ]
}

Headers

Section titled “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

Section titled “400”

Missing query parameter, invalid pagination parameters, or invalid type filter

Media typeapplication/json
object
error
object
code
string
details
message
string
Examplegenerated
{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

401

Section titled “401”

Unauthorized

Media typeapplication/json
object
error
object
code
string
details
message
string
Examplegenerated
{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
error
object
code
string
details
message
string
Examplegenerated
{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}

Headers

Section titled “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

Section titled “500”

Internal Server Error

Media typeapplication/json
object
error
object
code
string
details
message
string
Examplegenerated
{
  "error": {
    "code": "example",
    "details": "example",
    "message": "example"
  }
}