# BBB API — Better Business Bureau ratings, accreditation, reviews and complaints for US and Canadian businesses

> Find businesses on BBB with the site's own filters: what (name / trade / keyword) and where (city, ZIP, state; US or Canada), BBB category, letter grade, accredited only, distance (5-100 miles), accepts quote requests, serving my area, state; sorted by best match, distance, rating or name. Each row is one business LOCATION as BBB lists it (its address, phone, grade and accreditation; `local_report_url` is that location's page, `url` the business's main profile). 15 rows per page, 15 pages (225 rows) per search — `total` is the site's full count.
> ReefAPI engine `bbb` · 7 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/bbb/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/bbb/v1/search — 1 credit
Find businesses on BBB with the site's own filters: what (name / trade / keyword) and where (city, ZIP, state; US or Canada), BBB category, letter grade, accredited only, distance (5-100 miles), accepts quote requests, serving my area, state; sorted by best match, distance, rating or name. Each row is one business LOCATION as BBB lists it (its address, phone, grade and accreditation; `local_report_url` is that location's page, `url` the business's main profile). 15 rows per page, 15 pages (225 rows) per search — `total` is the site's full count.

**Parameters:**
- `query` (string, optional) — What to look for, as typed in the site's search box: a business name, a trade or a keyword (`plumber`, `amazon`). Needed unless `category` is given.
- `location` (string, optional) — Where: `City, ST`, a ZIP / postal code or a state (`Austin, TX`, `78753`, `Toronto, ON`). Empty = the whole country.
- `country` (enum, optional, default "us") — us (default) or ca. [one of: us, ca]
- `category` (array, optional) — BBB category: its code (`10113-000` = Plumber) or name (`Plumber`, `Roofing Contractors`); several = any of them. Without `query` the search lists that category.
- `state` (array, optional) — Only businesses in these states / provinces (`TX`, `CA`, `ON`); several = any of them.
- `rating` (array, optional) — BBB letter grade: A (= A+, A and A-), B, C, D, F; several = any of them. `A+`/`B-` style values map to their letter, as on the site.
- `accredited` (boolean, optional) — Only BBB Accredited Businesses.
- `distance` (integer, optional) — Within N miles of `location`: 5, 10, 25, 50 or 100.
- `quote_requests_only` (boolean, optional) — Only businesses that accept a quote request through BBB ('Get a Quote').
- `serving_area_only` (boolean, optional) — Only businesses that list the searched location in their service area ('Serving my Area').
- `sort` (enum, optional, default "relevance") — relevance (default, the site's 'Best Match'), distance, rating, name_asc (A-Z), name_desc (Z-A). [one of: relevance, distance, rating, name_asc, name_desc]
- `page` (integer, optional, default 1) — Result page 1-15 (15 rows each; the site stops at page 15).

**Returns:** total, total_pages, reachable, total_is_capped, page, per_page (15), has_more, rows[]{id, bbb_id, business_id, address_id, row_id, name, url, local_report_url, rating, rating_score, accredited, accreditation_status, is_charity, charity_seal, accredited_charity, address, city, state, postal_code, phones[], latitude, longitude, distance_miles, primary_category{id, name}, categories[]{id, name}, logo, bbb_office{id, name}, has_service_area, service_area, service_area_description, service_areas_summary[], out_of_business_status, accepts_quote_requests, request_quote_url, leave_review_url, business_login_url, score}, location{id, display_text, city, state, state_name, country, postal_code, postal_codes[], counties[], latitude, longitude, business_count, bbb_office{id, name}}, filter_options{categories[]{id, name}, states[]}, related_categories[]{name, url}, sort_options[], applied{}

**Example request body:**
```json
{
  "query": "plumber",
  "location": "Austin, TX"
}
```

### POST https://api.reefapi.com/bbb/v1/business — 2 credits
One business's full BBB profile: letter grade with BBB's reasons, accreditation (since / revoked), business start / incorporation dates, years in business, employees, entity type, owners and principals with titles, phones, fax, e-mail, websites, address, coordinates, opening hours, service area, categories, licences with the issuing agency, government-action alerts, products and services, refund policy, payment methods, social links, review and complaint summaries, latest reviews, first branches and the local BBB office.

**Parameters:**
- `business` (string, required) — The business: its BBB id `<bbb office>-<business id>` (`0825-1000223803`, the `id` of a `search` row) or any bbb.org profile link (any tab).

**Returns:** id, bbb_id, business_id, name, alternate_names[], url (the main profile), location_url + address_id (set when a location page was read), website, rating, rated, rating_reasons[], not_rated_reason, accredited, accreditation_status, accreditation_notes[], accredited_since, accreditation_revoked, dates{business_started, local_business_started, incorporated, new_owner, bbb_file_opened, accredited}, years_in_business, employees, entity_type, description, products_and_services, refund_and_exchange_policy, payment_methods[], service_types[], out_of_business, headquarters_info, phone, additional_phones[]{value, label}, fax_numbers[]{value, label}, text_number, email, additional_emails[], websites[], contacts[]{name, prefix, first_name, middle_name, last_name, suffix, title, is_principal, is_management, is_primary, is_customer_contact}, address{street, street_2, city, state, postal_code, country}, formatted_address, latitude, longitude, is_headquarters, is_us_based, hours{primary{monday..sunday: {hours[]{open, close}, note, closed}}, holiday}, serving_area, serving_areas[], primary_category{id, name}, categories[]{name, url}, high_risk_category, licenses[]{number, expires, notes, agency{…}}, licensing_notes[], social_media[]{type, label, url}, alerts[]{type_id, severity, title, text}, additional_information[]{title, text}, referral_assistance[], program_participation, complaint_filing_note, related_businesses[], claimed, accepts_quote_requests, is_multi_location, is_local_report, is_system_wide, reviews_summary{count, average_rating, suppressed, latest[]}, complaints_summary{count, count_is_capped, closed_last_3_years, closed_last_12_months}, locations{total, first[]}, media{logo, images[], videos[]}, bbb_office{name, url}, faq[]{question, answer}, breadcrumbs[], links{reviews, complaints, more_info, leave_review, file_complaint, request_quote, email_business, claim_business}

**Example request body:**
```json
{
  "business": "1296-7039385"
}
```

### POST https://api.reefapi.com/bbb/v1/reviews — 1 credit
A business's BBB customer reviews: star rating, reviewer's display name, date, full text, the business's reply and any follow-up thread; newest, highest or lowest first; up to 15 per page, every page reachable (`total` = the site's review count).

**Parameters:**
- `business` (string, required) — The business: its BBB id `<bbb office>-<business id>` (`0825-1000223803`, the `id` of a `search` row) or any bbb.org profile link (any tab).
- `sort` (enum, optional, default "recent") — recent (default), highest, lowest. [one of: recent, highest, lowest]
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 15) — Reviews per page, 1-15 (the site's maximum is 15).

**Returns:** business{id}, total, total_pages, page, per_page, has_more, sort, rows[]{id, guid, rating, author, date, text, business_response{text, date}, customer_response{text, date}, business_rebuttal{text, date}, thread[]{from, date, title, text}, status_id}

**Example request body:**
```json
{
  "business": "1296-7039385"
}
```

### POST https://api.reefapi.com/bbb/v1/complaints — 2 credits
A business's BBB complaints, 10 per page: complaint type, status (resolved / answered / unresolved / unanswered / unpursuable), date, the consumer's text and the whole response thread (business, consumer, BBB); filter by type and status, sort by date, status or type; with the business's uncapped per-status and per-type counts.

**Parameters:**
- `business` (string, required) — The business: its BBB id `<bbb office>-<business id>` (`0825-1000223803`, the `id` of a `search` row) or any bbb.org profile link (any tab).
- `status` (array, optional) — resolved, answered, unresolved, unanswered, unpursuable (the labels work too).
- `type` (array, optional) — Complaint type: productissues, serviceorrepair, delivery, billingissues, customerservice, salesadvertising, order, billing, sales, warranty, product, facilities (or the site's label, e.g. `Delivery Issues`). The business's own list with counts comes back in `counts_by_type`.
- `sort` (enum, optional, default "recent") — recent (default), status, type. [one of: recent, status, type]
- `page` (integer, optional, default 1) — Page 1-1000 (the site answers up to page 1000).

**Returns:** business{id, name, url, rating, accredited}, total, total_is_capped (the site stops counting at 10,000), total_pages, page, per_page (10), has_more, hidden_count, counts_by_status[]{status, count}, counts_by_type[]{type, count}, rows[]{id, type, status, date, text, responses[]{id, from (business|consumer|bureau), date, text}}, applied{}

**Example request body:**
```json
{
  "business": "1296-7039385"
}
```

### POST https://api.reefapi.com/bbb/v1/business_locations — 1 credit
Every location / branch BBB lists for a multi-location business (headquarters, branches, local reports in other bureaus), with phone, address, letter grade and accreditation; up to 15 per page.

**Parameters:**
- `business` (string, required) — The business: its BBB id `<bbb office>-<business id>` (`0825-1000223803`, the `id` of a `search` row) or any bbb.org profile link (any tab).
- `accredited` (boolean, optional) — Only accredited locations.
- `page` (integer, optional, default 1) — Page, 1-based.
- `per_page` (integer, optional, default 15) — Locations per page, 1-15 (the site's maximum).

**Returns:** total, total_locations, total_pages, page, per_page, accredited_only, has_more, rows[]{row_id, id, address_id, local_report, name, url, phone, address, city, state, postal_code, country, rating, accredited, headquarters, logo}

**Example request body:**
```json
{
  "business": "1296-7039385"
}
```

### POST https://api.reefapi.com/bbb/v1/suggest — 1 credit
BBB's own typeahead: businesses (id, profile link, address, accredited / headquarters tags) and BBB categories (code, name, slug) matching the start of a name, optionally ranked around a place.

**Parameters:**
- `query` (string, required) — Start of a business or category name (`amaz`, `plumb`).
- `type` (enum, optional, default "all") — all (default), business or category. [one of: all, business, category]
- `location` (string, optional) — Rank businesses around this place (`Seattle, WA`).
- `country` (enum, optional, default "us") — us (default) or ca. [one of: us, ca]

**Returns:** count, businesses[]{id, address_id, name, address, url, accredited, headquarters, tags[]}, categories[]{id, name, slug, url, tags[]}

**Example request body:**
```json
{
  "query": "plumb"
}
```

### POST https://api.reefapi.com/bbb/v1/places — 1 credit
BBB's own place typeahead: cities, states and ZIP / postal codes with coordinates and the local BBB office that serves them — the values `search` takes as `location`.

**Parameters:**
- `query` (string, required) — Start of a city or a ZIP / postal code (`chic`, `6065`, `toron`).
- `country` (enum, optional, default "us") — us (default) or ca. [one of: us, ca]
- `include_postal_codes` (boolean, optional, default true) — Also match ZIP / postal codes (default true).
- `limit` (integer, optional, default 10) — How many, 1-10 (the site's box shows 10).

**Returns:** count, rows[]{id, display_text, city, state, postal_code, country, latitude, longitude, bbb_office_id}

**Example request body:**
```json
{
  "query": "plumber"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=bbb
- Human docs page: https://reefapi.com/docs/bbb
- Overview page: https://reefapi.com/bbb-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
