Skip to content

Search foods

Finds foods to log in one library, by name, brand or barcode.

GEThttps://app.splot.health/v1/foods

Needs the Read permission. Use a result’s library and key as food when you create a meal.

ParameterTypeDescription
querystringWords from the name or brand, or a whole barcode. Generic ingredients need three characters or more. Up to 200 characters. Defaults to .
librarystringThe library to search. One of off, splot, mine or composition. Defaults to mine.
limitintegerHow many to return. From 1 to 100. Defaults to 30.
offsetintegerHow many to skip. Send the previous page's nextOffset. Defaults to 0.
localestringA language, such as de. Generic ingredients are named in it where they can be. Up to 80 characters.
regionstringA two-letter country, such as DE. Open Food Facts lists its products first.

The libraries are described in the food object. Without a query, mine lists your foods, those you eat most first.

200 with a page of foods and the offset of the next page, or null on the last.

{ "foods": [], "nextOffset": null }
Terminal window
curl "https://app.splot.health/v1/foods?library=composition&query=salmon&locale=en" \
-H "Authorization: Bearer $SPLOT_API_KEY"

Last updated