Search Ingredients
Runs an ingredient search on the server and returns matching ingredients — the caller organization's custom ingredients AND the requested market's standard reference ingredients, in one list where every custom-ingredient match ranks above every standard match. Pass q: "*" to browse (match everything visible for the market) instead of running a text search. Pass queries instead of q to search multiple terms in one call — each is ranked independently and results are returned as result_groups, one per input query.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://api.bettermenu.live/studio/ingredients/search" \ -H "Content-Type: application/json" \ -d '{ "market": "US" }'{
"results": [
{
"id": "string",
"name": "string",
"kind": "string",
"market": "string",
"used_in_recipes": 0,
"source": "string",
"score": 0
}
],
"total_found": 0,
"page": 0,
"result_groups": [
{
"position": 0,
"query": "string",
"results": [
{
"id": "string",
"name": "string",
"kind": "string",
"market": "string",
"used_in_recipes": 0,
"source": "string",
"score": 0
}
],
"total_found": 0
}
]
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}