Find a food
0.1 credits / searchSearches the food database by name and returns a list of candidate matches, each with a stable identifier, a description, and a data type (generic lab-analyzed vs. branded). This is the first step in looking up nutrition data: pick the best match and pass its ID to the food profile step for the complete nutrient numbers.
Use when
You have a food name and need to identify it before pulling its full nutrient profile.
Not for
Pulling the complete nutrient numbers (use the food profile step on the chosen match) or a packaged product by barcode.
Cost
0.1 credits / search
What it accepts
Set these inside the intent when you run it.
The food name to search for, distilled to core terms.
A brand name to filter results to a specific branded product.
What you get back
A list of candidate foods, each with a name, stable identifier, and data type indicating generic or branded.
Run it
Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Nutrition skill will route from your intent instead.)
curl -X POST "https://skill.askfaro.com/skills/nutrition/run" \
-H "Authorization: Bearer $FARO_TOKEN" \
-H "Content-Type: application/json" \
-d '{"intent":{"operation":"lookup_food","query":"raw spinach","brand":"Chobani"}}'Example requests
- ›What foods come up when I search for "greek yogurt"?
- ›Find the entry for raw spinach in the food database
- ›Search for cheddar cheese and show me the generic options