# BBB Business Search Scraper

> BBB Business Search Scraper is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Scrapes Better Business Bureau (BBB) business listings and profiles, returning structured business data including ratings, accreditation status, and profile URLs.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/bbb?utm_source=zero.xyz
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bbb-business-search-scraper-78b4c41f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_h0VUdnlG6SUryRn_rjq6X

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-scraper-78b4c41f -d '<json body>'
```

Example prompt: Search BBB for accredited electricians in Austin, Texas — sort by Rating, limit to 50 results, and give me each business's name, BBB rating, and profile URL.

## When to prefer this

Use this endpoint when you need structured BBB business data — ratings, accreditation status, and profiles — for businesses in the USA or Canada. Prefer this over manual BBB browsing or generic web scrapers when you need clean, normalized business records with BBB-specific fields like bbbRating and isAccredited. Especially useful for building vendor lists, due-diligence checks, or competitive research on local businesses.

## Known failure modes

- No results found for the given search terms and location — endpoint returns empty items array (not charged)
- Invalid or unreachable BBB URLs in startUrls — scrape fails silently or returns partial data
- Rate limiting or blocking by BBB — may return empty or partial results
- Invalid enum value for sort or country fields — request rejected with validation error
- Location not recognized by BBB — may return zero results

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of business items, each containing: business name, type, BBB ID, BBB rating, business ID, profile URL, rating score, and accreditation status. Failed or empty runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sort": {
   "enum": [
    "Relevance",
    "Rating",
    "Distance",
    "AToZ",
    "ZToA"
   ],
   "type": "string",
   "default": "Relevance",
   "description": "Order returned by the public search endpoint."
  },
  "country": {
   "enum": [
    "USA",
    "CAN"
   ],
   "type": "string",
   "default": "USA",
   "description": "Country for keyword searches."
  },
  "distance": {
   "type": "integer",
   "maximum": 500,
   "minimum": 1,
   "description": "Optional distance filter for searches with a location."
  },
  "location": {
   "type": "string",
   "description": "City and state or province for keyword searches. Leave empty for a country-wide search."
  },
  "maxItems": {
   "type": "integer",
   "default": 100,
   "minimum": 1,
   "description": "Maximum unique businesses to save across all searches and URLs."
  },
  "startUrls": {
   "type": "array",
   "description": "Public BBB search URLs or direct business profile URLs. Profile URLs are resolved through search listings."
  },
  "searchTerms": {
   "type": "array",
   "description": "Business categories or keywords to search. Each term is combined with the location."
  },
  "accreditedOnly": {
   "type": "boolean",
   "default": false,
   "description": "Return only businesses marked as accredited in the search listing."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "name": null,
    "type": null,
    "bbbId": null,
    "bbbRating": null,
    "businessId": null,
    "profileUrl": null,
    "ratingScore": null,
    "isAccredited": null
   }
  ],
  "product": "bbb"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bbb-business-search-scraper-78b4c41f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)