Nutrients API

Retrieve detailed nutrient profiles for ingredients, including macros, micros, vitamins, and minerals. Field availability is gated by plan.

Authentication

All endpoints require the x-api-key header. Response codes: 200 OK, 401 Auth Error, 429 Limited.

Endpoints

Method	Path	Description
GET	/nutrients	List nutrient profiles with pagination and advanced filtering (plan-based)
GET	/nutrients/search	Search ingredients and return nutrient data (gated by plan)
GET	/nutrients/search/{search_text}	Path-param variant
GET	/nutrients/{ingredient_id}	Get nutrient profile for an ingredient (fields gated by plan)

List Nutrient Profiles

GET/nutrients

Return a paginated list of nutrient profiles. Filter results with query parameters. Fields gated by plan.

Query Parameters

Parameter	Type	Default	Description
limit	integer	10	Basic max 10, Pro max 50, Custom max 100
offset	integer	0	Pagination offset
category	string	-	Filter by category
protein_min	number	-	Minimum protein content
fat_min	number	-	Minimum fat content
carbs_min	number	-	Minimum carbs content
fiber_min	number	-	Minimum fiber content
sodium_max	number	-	Maximum sodium content
energy_max	number	-	Maximum energy (kcal)
nutrition_min	number	-	Minimum nutrition score
nutrition_max	number	-	Maximum nutrition score
sustainability_min	number	-	Minimum sustainability score
sustainability_max	number	-	Maximum sustainability score

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients?limit=10&protein_min=5" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients?limit=10&protein_min=5" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

Response200 OK

{
  "items": [
    {
      "fat": "",
      "fiber": "",
      "sugar": "",
      "sodium": "",
      "carbs": "",
      "energy": "",
      "protein": "",
      "id": "65d5d345cc535e012de2fc49",
      "name": "Example Nutrient Name"
    }
  ],
  "pagination": {
    "total_count": 100,
    "limit": 10,
    "offset": 0,
    "has_next": true,
    "has_previous": false
  }
}

{
  "items": [
    {
      "fat": "",
      "fiber": "",
      "sugar": "",
      "sodium": "",
      "carbs": "",
      "energy": "",
      "protein": "",
      "id": "65d5d345cc535e012de2fc49",
      "name": "Example Nutrient Name"
    }
  ],
  "pagination": {
    "total_count": 100,
    "limit": 10,
    "offset": 0,
    "has_next": true,
    "has_previous": false
  }
}

Search Nutrient Profiles

GET/nutrients/search

Search ingredients and return nutrient data. Fields gated by plan.

Query Parameters

Parameter	Type	Required	Description
q	string	Yes	Search query

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients/search?q=orange" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients/search?q=orange" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

Response200 OK

[
  {
    "id": "65d5d3e1cc535e012de30da1",
    "name": "Bitter Orange",
    "nutrition_score": 72.73,
    "sustainability_score": 0,
    "carbs": "17.56",
    "fat": "",
    "sodium": "1.4",
    "calcium": "60.2",
    "serving_size": "1",
    "sugar": "11.9",
    "vitamin_d_iu": "",
    "vitamin_d": "0",
    "cholesterol": "0",
    "potassium": "232.4",
    "saturated_fat": "0.02",
    "vitamin_c": "82.74",
    "nutrition_source": "",
    "energy": "68.6",
    "fiber": "3.08",
    "trans_fat": "0",
    "iron": "0.182",
    "protein": "1.27"
  }
]

[
  {
    "id": "65d5d3e1cc535e012de30da1",
    "name": "Bitter Orange",
    "nutrition_score": 72.73,
    "sustainability_score": 0,
    "carbs": "17.56",
    "fat": "",
    "sodium": "1.4",
    "calcium": "60.2",
    "serving_size": "1",
    "sugar": "11.9",
    "vitamin_d_iu": "",
    "vitamin_d": "0",
    "cholesterol": "0",
    "potassium": "232.4",
    "saturated_fat": "0.02",
    "vitamin_c": "82.74",
    "nutrition_source": "",
    "energy": "68.6",
    "fiber": "3.08",
    "trans_fat": "0",
    "iron": "0.182",
    "protein": "1.27"
  }
]

Search Nutrient Profiles (Path Param)

GET/nutrients/search/{search_text}

Path-parameter variant of search. Pass the search text directly in the URL path.

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients/search/orange" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients/search/orange" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

Response200 OK

[
  {
    "id": "65d5d3e1cc535e012de30da1",
    "name": "Bitter Orange",
    "nutrition_score": 72.73,
    "sustainability_score": 0,
    "carbs": "17.56",
    "fat": "",
    "sodium": "1.4",
    "calcium": "60.2",
    "serving_size": "1",
    "sugar": "11.9",
    "vitamin_d_iu": "",
    "vitamin_d": "0",
    "cholesterol": "0",
    "potassium": "232.4",
    "saturated_fat": "0.02",
    "vitamin_c": "82.74",
    "nutrition_source": "",
    "energy": "68.6",
    "fiber": "3.08",
    "trans_fat": "0",
    "iron": "0.182",
    "protein": "1.27"
  }
]

[
  {
    "id": "65d5d3e1cc535e012de30da1",
    "name": "Bitter Orange",
    "nutrition_score": 72.73,
    "sustainability_score": 0,
    "carbs": "17.56",
    "fat": "",
    "sodium": "1.4",
    "calcium": "60.2",
    "serving_size": "1",
    "sugar": "11.9",
    "vitamin_d_iu": "",
    "vitamin_d": "0",
    "cholesterol": "0",
    "potassium": "232.4",
    "saturated_fat": "0.02",
    "vitamin_c": "82.74",
    "nutrition_source": "",
    "energy": "68.6",
    "fiber": "3.08",
    "trans_fat": "0",
    "iron": "0.182",
    "protein": "1.27"
  }
]

Get Nutrient Profile

GET/nutrients/{ingredient_id}

Retrieve detailed nutrient information for a specific ingredient. Fields limited by plan.

Path Parameters

Parameter	Type	Required	Description
ingredient_id	string	Yes	Ingredient ID

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients/65d5d3e1cc535e012de30da2" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

curl "https://developer-portal-backend-694046361762.northamerica-northeast1.run.app/nutrients/65d5d3e1cc535e012de30da2" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Accept: application/json"

Response200 OK

{
  "id": "65d5d3e1cc535e012de30da2",
  "name": "Bitter Orange Extract",
  "nutrition_score": 72.73,
  "sustainability_score": 0,
  "carbs": "0.53",
  "fat": "",
  "sodium": "0.38",
  "calcium": "0.462",
  "serving_size": "1",
  "sugar": "0.53",
  "vitamin_d_iu": "",
  "vitamin_d": "0",
  "cholesterol": "0",
  "potassium": "6.22",
  "saturated_fat": "0",
  "vitamin_c": "0",
  "nutrition_source": "",
  "energy": "12.1",
  "fiber": "0",
  "trans_fat": "0",
  "iron": "0.005",
  "protein": "0"
}

{
  "id": "65d5d3e1cc535e012de30da2",
  "name": "Bitter Orange Extract",
  "nutrition_score": 72.73,
  "sustainability_score": 0,
  "carbs": "0.53",
  "fat": "",
  "sodium": "0.38",
  "calcium": "0.462",
  "serving_size": "1",
  "sugar": "0.53",
  "vitamin_d_iu": "",
  "vitamin_d": "0",
  "cholesterol": "0",
  "potassium": "6.22",
  "saturated_fat": "0",
  "vitamin_c": "0",
  "nutrition_source": "",
  "energy": "12.1",
  "fiber": "0",
  "trans_fat": "0",
  "iron": "0.005",
  "protein": "0"
}