Diaspora business search
Search the Ni Biashara diaspora business registry: 2,864 African and Black diaspora businesses across 424 metros and 91 categories. Filter by text, metro, category, city, verification status and channels on file; records carry contacts, directory page and claim state, with the snapshot date disclosed.
$0.25 per call — paid in USDC on Base over the x402 protocol, settled by Coinbase. No API key, no signup.
Parameters
| param | description |
|---|---|
q | free text over name, category, city and blurb (optional) |
metro | metro to filter, e.g. DFW, Houston, Toronto (optional) |
category | exact registry category, e.g. Restaurants & Food (optional) |
city | exact city (optional) |
verified_only | true restricts to verification-passed records (optional) |
has | channel on file: website, phone, instagram or facebook; repeatable or comma-separated (optional) |
limit | max records to return (optional, default 25, max 60) |
offset | records 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/diaspora-business-search?q=&metro=&category=&city=&verified_only=&has=&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/diaspora-business-search?q=&metro=&category=&city=&verified_only=&has=&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.
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": "diaspora-business-search",
"query": {
"metro": "DFW",
"limit": 3
},
"count": 161,
"returned": 1,
"results": [
{
"id": "5-senses-nigerian-fusion-dallas",
"name": "5 Senses Nigerian Fusion",
"category": "Restaurants & Food",
"metro": "DFW",
"city": "Dallas",
"website": "https://5sensescuisine.com/",
"facebook": "",
"instagram": "",
"phone": "(682) 220-4228",
"blurb": "Restaurant in Dallas.",
"page": "https://nibiashara.com/b/5-senses-nigerian-fusion-dallas/",
"api": "https://nibiashara.com/api/v1/businesses/5-senses-nigerian-fusion-dallas.json",
"claim_open": true,
"verification": {
"verified": false,
"website_status": "present_unverified",
"basis": "Registry listing with a website on file that has not been flagged; the business has not yet been through an individual verification pass.",
"checked_at": "2026-11-19"
},
"source": "Ni Biashara diaspora business registry (nibiashara.com directory data) — public business listing data, human-reviewed at intake",
"as_of": "2026-11-20"
}
],
"source": "Ni Biashara diaspora business registry (nibiashara.com directory data) — public business listing data, human-reviewed at intake",
"as_of": "2026-11-20",
"cache": "Snapshot data — registry snapshot as_of 2026-11-19; refreshed when the registry is re-verified, not pulled live per call.",
"illustrative": true
}
Delivers
JSON { count, returned, results[] (id, name, category, metro, city, website, facebook, instagram, phone, blurb, page, api, claim_open, verification{ verified, website_status, basis, checked_at }), source, as_of, cache disclosure }