For AI agents
Check a business in one call.
AI agents and the people who run them can check whether a business is listed with GET /api/v1/verify. Each match has a verified field: true when the owner confirmed the listing, or Ni Biashara has dealt with the business directly, and false on a possible match. Without a key, each visitor gets a fair limit of 60 checks a day.
- Free agent tier
- No sign-up needed to start
- Base URL
- https://nibiashara.com/api/v1
- No key
- 60 checks a day per visitor
- With a key
- 3,000 checks a month
- Burst
- 30 requests in 10 seconds per address at the edge, then blocked for 600 seconds
- MCP
- server card · /mcp
- A2A
- agent card · /a2a
- OpenAPI
- /api/v1/openapi.json
- Counts snapshot
- /api, paid over x402
- Auth
- auth.md
First call
request
curl -s 'https://nibiashara.com/api/v1/verify?name=M%26M%20African%20Kitchen'response, as returned on Nov 10, 2026 (abridged: phone, website and note fields omitted here)
{
"result": "LISTED",
"matches": [
{
"id": "m-m-african-kitchen-bar-frisco",
"name": "M&M African Kitchen & Bar",
"category": "Restaurants & Food",
"metro": "DFW",
"city": "Frisco",
"url": "https://nibiashara.com/b/m-m-african-kitchen-bar-frisco",
"listed": true,
"status": "verified_client",
"verified": true,
"match": "strong"
}
],
"plan": "free",
"source": "https://nibiashara.com"
}Endpoints
| Endpoint | Returns | Limit | Price |
|---|---|---|---|
| GET /api/v1/verify | Whether a business is listed, and whether it is verified | 60 a day without a key; 3,000 a month with one; and 30 requests in 10 seconds per address at the edge, then blocked for 600 seconds | Free |
| GET /api/v1/search | Keyword search of listings: name, blurb, category, city, metro | 30 requests in 10 seconds per address at the edge, then blocked for 600 seconds | Free |
| GET /api/v1/businesses.json | Every listing, versioned v1 (CC BY 4.0 curation) | Not limited today | Free |
| GET /api/v1/reads | AI-read counts with 7-day breakdowns; ?business= for one listing | Not limited today | Free |
| GET /api/v1/report | Week-over-week AI-read report with a 14-day series | Not limited today | Free |
| POST /mcp | MCP server, Streamable HTTP, read-only search_directory | 30 requests in 10 seconds per address at the edge, then blocked for 600 seconds | Free |
| POST /a2a | A2A JSON-RPC message/send for listing search | 30 requests in 10 seconds per address at the edge, then blocked for 600 seconds | Free |
| GET /api | Listing counts by metro and category, a paid snapshot | 30 requests in 10 seconds per address at the edge, then blocked for 600 seconds | Paid over x402; the 402 response states the terms |
Fair-use terms
- Sign up to get an API key with a higher limit (3,000 checks a month) and a listing in our agent directory.
- We email a code to confirm your address; the key's monthly quota, any listing or badge start only after you confirm it.
- One active key per email.
- Agents that waste requests are cut off and blocklisted; contact us about a block.
- A public verified badge comes after a working agent card and 30 days with no abuse.
- Our ranking of agents stays private.
- Operators and agencies get the same terms.
Get a key
An agent with no person behind it starts at POST /agent/identity (see auth.md) and can finish alone; the form below is for people.
What we keep and why: Privacy.