data · instant recipes-collection-dossier
Recipe collection dossier (premium)
Premium dossier over a region or cuisine of the Ni Biashara recipes shelf: the full dish records plus per-dish sourcing notes and substitution chains, with the snapshot's actual coverage named. Built for menu planning; coverage is what the shelf really holds, never invented dishes.
$2.50 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.
Parameters
| param | description |
|---|---|
region | region text, e.g. Kenyan Coast (this or cuisine required) |
cuisine | exact cuisine, e.g. Kenyan (this or region required) |
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-collection-dossier?region=&cuisine="
# 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-collection-dossier?region=&cuisine=");
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.
Example response (illustrative shape, not a live rate)
{
"shelf": "recipes-collection-dossier",
"publisher": "Ni Biashara",
"canonical_url": "https://nibiashara.biz/shelf/recipes-collection-dossier",
"license": "https://nibiashara.biz/terms#data-license",
"query": {
"region": null,
"cuisine": "kenyan"
},
"count": 1,
"dishes": [
{
"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)"
}
],
"sourcing_by_dish": [
{
"id": "kenyan-beef-pilau",
"title": "Kenyan Beef Pilau (Pilau ya Nyama ya Ng'ombe)",
"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"
}
]
}
],
"substitution_chains": [
{
"id": "kenyan-beef-pilau",
"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"
}
]
}
],
"menu_planning_note": "Menu-planning sets (week of dinners, celebration menu) are assembled from the dishes in this dossier. v1 coverage is the launch snapshot — one fully worked dish — so sets are limited to what is actually on the shelf; the dossier names that coverage rather than inventing dishes.",
"coverage_note": "Dossier covers 1 dish(es) in the 2026-11-20 snapshot for this region/cuisine.",
"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",
"illustrative": true
}
Delivers
JSON { count, dishes[], sourcing_by_dish[], substitution_chains[], menu_planning_note, coverage_note, source, as_of }