Food search

GET /v1/food/search · $0.001 a call

Look up a food by name, for manual logging or to correct a scan. Returns the closest matches from the same reference nutrition database the scan endpoints use, best first, each with calories, protein, carbs, fat and fiber per 100 g. No model is involved, so it is fast and cheap.

For calorie trackers, recipe and meal planners.

Request

Send these fields as query parameters on GET /v1/food/search. No photo is needed.

Field	Type	Description
`q`	string, up to 100 characters, required	What to look up, in plain words.
`limit`	number, 1 to 20	How many matches to return, 1 to 20. Defaults to 5.

Photo tips. No photo. Short searches work best: "greek yogurt plain", "rice white cooked".

1curl "https://truelens.keronlabs.com/v1/food/search?q=chicken%20breast%20roasted" \
2  -H "Authorization: Bearer $TRUELENS_KEY"

Response

Field	Description
`summary`	One line, e.g. "5 matches for chicken breast roasted".
`query`	The search text you sent.
`foods[].id`	A stable id for this food. The same food always has the same id.
`foods[].description`	The food name.
`foods[].per_100g`	calories, protein_g, carbs_g, fat_g, fiber_g per 100 g.

Example

Output of this API’s own code on the sample request above.

1{
2  "metadata": {
3    "id": "req_9cf4da08fe7f40dab71a",
4    "engine": "food/search",
5    "status": "success",
6    "cached": false,
7    "credits_used": 0.1,
8    "created_at": "2026-10-19T09:30:00.000Z",
9    "processing_ms": 40
10  },
11  "summary": "5 matches for chicken breast roasted",
12  "query": "chicken breast roasted",
13  "foods": [
14    {
15      "id": "f_1gfmrlw",
16      "description": "Chicken breast, roll, oven-roasted",
17      "per_100g": {
18        "calories": 134,
19        "protein_g": 14.6,
20        "carbs_g": 1.79,
21        "fat_g": 7.65,
22        "fiber_g": 0
23      }
24    },
25    {
26      "id": "f_1f9azos",
27      "description": "Chicken breast, oven-roasted, fat-free, sliced",
28      "per_100g": {
29        "calories": 79,
30        "protein_g": 16.8,
31        "carbs_g": 2.17,
32        "fat_g": 0.39,
33        "fiber_g": 0
34      }
35    },
36    {
37      "id": "f_1q0hrlh",
38      "description": "Chicken, broilers or fryers, breast, meat only, cooked, roasted",
39      "per_100g": {
40        "calories": 165,
41        "protein_g": 31,
42        "carbs_g": 0,
43        "fat_g": 3.57,
44        "fiber_g": 0
45      }
46    },
47    {
48      "id": "f_1b8wpw3",
49      "description": "Chicken, broilers or fryers, breast, meat and skin, cooked, roasted",
50      "per_100g": {
51        "calories": 197,
52        "protein_g": 29.8,
53        "carbs_g": 0,
54        "fat_g": 7.78,
55        "fiber_g": 0
56      }
57    },
58    {
59      "id": "f_0754xpj",
60      "description": "Chicken breast, baked, broiled, or roasted, skin eaten, from raw",
61      "per_100g": {
62        "calories": 192,
63        "protein_g": 26.2,
64        "carbs_g": 0,
65        "fat_g": 8.8,
66        "fiber_g": 0
67      }
68    }
69  ]
70}