BetterMenu
Ingredients search

Search Ingredients

GET
/ingredients/search

Authorization

BearerAuth
AuthorizationBearer <token>

JWT Bearer token authentication

In: header

Query Parameters

country_code*string

Country code (e.g., US)

type?string

Item type filter (ingredient, product, or all)

Default"all"
Value in"ingredient" | "product" | "all"
cursor?|

Pagination cursor for next page

limit?integer

Number of results per page (max 20)

Default10
Range1 <= value <= 20
query*string

Search query

Lengthlength <= 200

Response Body

application/json

application/json

curl -X GET "https://evh09u6ys0.execute-api.us-west-2.amazonaws.com/ingredients/search?country_code=US&query=string"
{
  "data": [
    {
      "item_type": "ingredient",
      "id": "f_dXNkYV9mbmRkczoy",
      "name": "Milk, whole, 3.25% milkfat",
      "category": "Dairy and Egg Products",
      "nutrients": [
        {
          "id": "n_qr2jbh18w4hmo",
          "name": "protein",
          "amount": "string",
          "unit": "g"
        }
      ]
    }
  ],
  "pagination": {
    "cursor": "string",
    "has_more": true,
    "limit": 1
  },
  "meta": {
    "version": "2025-10-07.preview",
    "request_id": "req_abc123xyz",
    "timestamp": "2025-10-07T10:30:15Z"
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}