ShelvesNI BIASHARA
data · instant diaspora-business-search

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

paramdescription
qfree text over name, category, city and blurb (optional)
metrometro to filter, e.g. DFW, Houston, Toronto (optional)
categoryexact registry category, e.g. Restaurants & Food (optional)
cityexact city (optional)
verified_onlytrue restricts to verification-passed records (optional)
haschannel on file: website, phone, instagram or facebook; repeatable or comma-separated (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/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.

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": "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 }

← all shelves