# BBB Business Search & Profile Scraper

> BBB Business Search & Profile Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.25/call, status unknown (last checked 2026-10-02).

Searches the Better Business Bureau directory and returns structured business profile data including BBB ratings and accreditation status

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/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-profile-scraper-acbd801d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3dAV2CVwoIzhovN1pWmTt

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-profile-scraper-acbd801d -d '<json body>'
```

Example prompt: Search the BBB directory for accredited plumbers in Chicago, Illinois — sort by Rating and return up to 50 results with their BBB scores and profile URLs.

## When to prefer this

Use this endpoint when you need structured BBB business data — ratings, accreditation status, and profile details — from keyword or category searches across US or Canadian markets. Prefer this over manual web scraping when you need reliable, pay-only-on-success extraction of BBB directory data at scale, or when validating business trustworthiness by BBB credentials.

## Known failure modes

- No results returned if search terms match no BBB listings — not charged
- Invalid enum value for sort or country fields returns a validation error
- Distance filter ignored if no location is provided
- BBB website structural changes may cause empty or malformed responses
- Rate limiting or blocking by BBB may result in empty runs

## 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 and array of business items, each containing the business name, type, BBB ID, business ID, BBB rating letter grade, numeric rating score, profile URL, and accreditation status. Failed or empty runs are not billed.

## 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-profile-scraper-acbd801d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)