# BBB Business Search via SiteCheck Company Records

> BBB Business Search via SiteCheck Company Records is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches the Better Business Bureau (bbb.org) public directory by business name and returns location, category, BBB rating, membership status, and profile ID.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/bbb?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bbb-business-search-via-sitecheck-company-records-3571602e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6eZGWuDx8jYRj0kA0h_VL

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bbb-business-search-via-sitecheck-company-records-3571602e
```

Example prompt: Can you look up 'Apple Remodeling' on the Better Business Bureau and tell me their BBB rating, whether they're a BBB member, and what category they're listed under?

## When to prefer this

Use this endpoint when you need quick, structured BBB data (rating, accreditation, category, location) for US businesses by name without scraping bbb.org directly. Prefer this over general web search when you need machine-readable BBB ratings for vendor vetting, lead enrichment, or consumer protection checks. Note: returns public listing data only — no complaint counts or complaint narratives.

## Known failure modes

- No results found for obscure or misspelled business names
- Multiple ambiguous matches returned when the name is too generic
- BBB data may be stale or differ from live bbb.org listings
- Limit parameter out of range (must be 1–15) returns an error
- Query string shorter than 2 or longer than 60 characters is rejected
- Rate limiting or API quota exceeded for high-volume usage

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

Returns a JSON object with a count of matches, the original query, the BBB source URL, a checkedAt timestamp, and an array of business results each containing: business name, city, state, postal code, BBB letter rating (e.g. A+), business category, BBB membership boolean, and a profile ID that can be used to construct a direct BBB profile URL.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Business name, 2 to 60 characters"
      },
      "limit": {
       "type": "string",
       "description": "Rows to return, 1 to 15 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 15,
  "query": "apple",
  "source": "https://www.bbb.org/api/search",
  "results": [
   {
    "city": "Townsend",
    "name": "Apple Roofing",
    "state": "DE",
    "rating": "A+",
    "category": "Roofing Contractors",
    "bbbMember": true,
    "profileId": "0251_92008892_62550",
    "postalCode": "19734-7714"
   },
   {
    "city": "Parker",
    "name": "Apple Remodeling",
    "state": "CO",
    "rating": "A+",
    "category": "General Contractor",
    "bbbMember": true,
    "profileId": "1296_9035069_810086",
    "postalCode": "80138"
   }
  ],
  "checkedAt": "2026-10-23T09:37:34.721Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bbb-business-search-via-sitecheck-company-records-3571602e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)