ShelvesNI BIASHARA
data · instant recipes-search

Recipe search — dishes as structured data

Search the Ni Biashara recipes shelf: dishes as thick structured records (ingredients with quantities and units, timed steps, substitutions, dietary tags, and sourcing notes for diaspora buyers). Filter by text, cuisine, region, dietary tag or total-time budget. v1 launches with the fully worked Kenyan beef pilau record and grows through the daily depth pass.

$0.25 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.

Parameters

paramdescription
qfree text over title, cuisine, region, tags and ingredient names (optional)
cuisineexact cuisine, e.g. Kenyan (optional)
regionregion text, e.g. Kenyan Coast (optional)
dietarydietary tag on the record, e.g. gluten-free (optional)
max_minutesonly dishes whose total time is at most this many minutes (optional)
limitmax records to return (optional, default 25, max 60)
offsetrecords to skip (optional, default 0)

Call it (any x402 client)

# 1. GET without payment → HTTP 402 with PAYMENT-REQUIRED (price, payTo, scheme "exact")
curl -i "https://agents.nibiashara.biz/shelf/recipes-search?q=&cuisine=®ion=&dietary=&max_minutes=&limit=&offset="

# 2. Sign the payment (EIP-3009 transferWithAuthorization, gasless) and retry
#    with the PAYMENT-SIGNATURE header → response body is the delivery.

With the official JS client the whole flow is one wrapped fetch:

import { wrapFetchWithPayment } from "@x402/fetch";       // npm i @x402/fetch @x402/evm
const fetchPaid = wrapFetchWithPayment(fetch, { /* your EVM signer */ });
const res = await fetchPaid("https://agents.nibiashara.biz/shelf/recipes-search?q=&cuisine=®ion=&dietary=&max_minutes=&limit=&offset=");
const data = await res.json();

Or install the MCP server (https://agents.nibiashara.biz/mcp, registry id biz.nibiashara/shelves) and use the job-named tool for this shelf, or buy_shelf as an escape hatch.

Calling this repeatedly? Buy a Shelf Pass once ($0.99 for 110 credits) and send X-SHELF-PASS: <token> instead of paying per call — this shelf costs 25 credits per call.

Example response (illustrative shape, not a live rate)

{
  "shelf": "recipes-search",
  "publisher": "Ni Biashara",
  "canonical_url": "https://nibiashara.biz/shelf/recipes-search",
  "license": "https://nibiashara.biz/terms#data-license",
  "query": {
    "q": "pilau"
  },
  "count": 1,
  "returned": 1,
  "results": [
    {
      "as_of": "2026-11-20",
      "commerce": {
        "agent_checkout": "x402-usdc",
        "human_checkout": "stripe",
        "page_url": "https://kanairodrop.com/food/kenyan-beef-pilau/",
        "price_usd": null
      },
      "course": "main",
      "cuisine": "Kenyan",
      "description": "The celebratory rice of the Kenyan coast — basmati cooked in a dark, caramelised onion and beef stock with whole pilau masala (cumin, cardamom, cinnamon, cloves, black pepper), potatoes absorbing the spiced broth. Served at weddings, Eid, Christmas and any gathering that matters, always with kachumbari and a ripe banana on the side.",
      "dietary_tags": [
        "gluten-free",
        "dairy-free",
        "halal-friendly"
      ],
      "difficulty": "medium",
      "equipment": [
        "large heavy pot with a tight-fitting lid (sufuria)",
        "wooden spoon",
        "sharp knife and board"
      ],
      "id": "kenyan-beef-pilau",
      "ingredients": [
        {
          "name": "beef (chuck or stewing beef)",
          "note": "cut into bite-size cubes; bone-in pieces add depth if you have them",
          "optional": false,
          "quantity": 750,
          "section": "pilau",
          "unit": "g"
        },
        {
          "name": "basmati rice",
          "note": "rinsed until the water runs clear, soaked 30 minutes, drained",
          "optional": false,
          "quantity": 500,
          "section": "pilau",
          "unit": "g"
        },
        {
          "name": "yellow onions",
          "note": "finely sliced — these are the colour and the base of the dish",
          "optional": false,
          "quantity": 4,
          "section": "pilau",
          "unit": "piece"
        }
      ],
      "pairing": {
        "condiments": [
          "pilipili (fresh chilli sauce)",
          "ripe banana on the side — eaten bite-for-bite with the pilau, non-negotiable on the coast"
        ],
        "drinks": [
          "madafu (fresh coconut water)",
          "tangawizi (ginger) soda or a cold Tusker if serving in Kenya"
        ],
        "sides": [
          "kachumbari (included in this record)",
          "steamed cabbage",
          "sukuma wiki"
        ]
      },
      "region": "Kenyan Coast (Swahili)",
      "servings": 6,
      "source": "Ni Biashara recipes shelf — traditional Kenyan coastal preparation, quantities standardised and tested in the writing (metric, serves 6)",
      "sourcing_notes": [
        {
          "ingredient": "pilau masala",
          "note": "Sold pre-ground as 'pilau masala' or 'Kenyan pilau mix'. If only whole spices are available, pound 1 tbsp cumin seeds, 1 tsp cardamom pods, 1 cinnamon stick, 1 tsp cloves, 1 tsp black peppercorns per batch.",
          "where": "African grocery (spice aisle) — diaspora grocers stock Kenyan brands (e.g. Tropical Heat, Nature's Own)"
        },
        {
          "ingredient": "basmati rice",
          "note": "Aged long-grain basmati holds the grains separate; the soak is what keeps it from going sticky in the stock.",
          "where": "Any South Asian or African grocery; supermarket 'own brand' basmati is a step down but works"
        },
        {
          "ingredient": "beef",
          "note": "Chuck or any stewing cut with some fat; avoid lean steak cuts, they dry out in the browning stage.",
          "where": "Halal butcher or supermarket stewing beef"
        }
      ],
      "steps": [
        {
          "minutes": 15,
          "n": 1,
          "text": "Boil the beef: put the beef cubes in a pot with salted water, bring to a boil and simmer 25–30 minutes until tender. Reserve the cooking liquid — top it up to 900 ml with hot water; this is your pilau stock. (While the beef cooks, slice the onions and prep everything else.)"
        },
        {
          "minutes": 10,
          "n": 2,
          "text": "Heat the oil in the large pot over medium-high heat. Fry the sliced onions slowly, stirring, until deep mahogany brown — 10 to 12 minutes. This is the pilau's colour and sweetness; pale onions make pale pilau. Don't burn them black."
        },
        {
          "minutes": 3,
          "n": 3,
          "text": "Add the garlic paste and grated ginger, fry 1 minute. Add the pilau masala and stir 30 seconds until the oil smells of the spices."
        }
      ],
      "substitutions": [
        {
          "for": "beef",
          "notes": "The coastal classic alternative. Brown it the same way; it needs no pre-boiling — add it after the tomatoes and extend step 7 steaming by 5 minutes.",
          "with": "goat meat (mbuzi), same weight, bone-in"
        },
        {
          "for": "pilau masala",
          "notes": "Covers the warmth but misses the cardamom-clove top note; add a pinch of ground cardamom if you have it.",
          "with": "garam masala, 2 tbsp plus 1 tsp extra cumin"
        },
        {
          "for": "basmati rice",
          "notes": "Reduce stock to 800 ml and check at 18 minutes — jasmine goes soft faster.",
          "with": "long-grain jasmine rice"
        }
      ],
      "tags": [
        "wedding food",
        "celebration",
        "one-pot"
      ],
      "time": {
        "cook_minutes": 75,
        "prep_minutes": 30,
        "total_minutes": 105
      },
      "title": "Kenyan Beef Pilau (Pilau ya Nyama ya Ng'ombe)"
    }
  ],
  "source": "Ni Biashara recipes shelf — traditional preparations with standardised, cookable quantities, written and checked per record (see each record's source field)",
  "as_of": "2026-11-20",
  "cache": "Snapshot data — recipes snapshot as_of 2026-11-20; new dishes land via the daily shelves-depth pass, not pulled live per call.",
  "illustrative": true
}

Delivers

JSON { count, returned, results[] (full recipe records), source, as_of, cache disclosure }

← all shelves