BETTERMENU
Studio

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.

POST
/studio/ingredients/search

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
    }
  ]
}
Empty
Empty
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}
Empty
BETTERMENU

FDA-compliant nutrition labels from a recipe, in minutes.

Visit bettermenu.live