BBB (Better Business Bureau) API & Scraper
The BBB API returns Better Business Bureau data for US and Canadian businesses from bbb.org as JSON: business search with BBB's own filters, the full profile with letter grade, accreditation, owners, phones and licences, every customer review and every complaint with the business's response.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
It reads bbb.org logged out. `search` finds businesses by name, trade or keyword near a city, ZIP / postal code or state in the United States or Canada, with the filters BBB's own search page offers: BBB category, letter grade (A to F), accredited only, distance (5 to 100 miles), accepts quote requests, serves my area, state, and sorting by best match, distance, rating or name. Each row is one business location as BBB lists it, with its BBB id, name, address, phone, letter grade, BBB rating score, accreditation, categories, coordinates, service-area counties and the local BBB office. `business` returns the whole BBB profile: letter grade with BBB's reasons, accredited since, business start and incorporation dates, years in business, employees, entity type, owners and principals with their titles, phones, fax, e-mail, websites, address, coordinates, opening hours, service area, licences with the issuing agency, government-action alerts, products and services, refund policy, payment methods, social links, review and complaint counts and the first branches. `reviews` returns every customer review (star rating, reviewer display name, date, full text, the business's reply), newest, highest or lowest first. `complaints` returns every complaint (type, status, date, the consumer's text and the whole response thread), filterable by type and status, with the business's per-status and per-type counts. `business_locations` lists every location BBB has for a multi-location business, and `suggest` / `places` are BBB's own business, category and place lookups.
What a BBB field actually contains
Fields that read differently from how they look. Every row was measured against live bbb.org on 2026-11-15 and 2026-11-16.
| Field | What it holds |
|---|---|
| search rows | One business location each, as BBB's result list shows it: the address, phone, letter grade and accreditation of that location. local_report_url is that location's own BBB page, url the business's main profile. On 24 sampled rows the street differed from the main profile on 8 (PO boxes, branches, other bureaus); against the location's own page street, city, state, phone and grade matched 12 of 12. |
| rating | BBB's letter grade, A+ to F. On search rows a business BBB does not rate has an empty grade (null); its profile says NR. The rating filter takes letters: A returns A+, A and A-. |
| rating_score | BBB's numeric score behind the letter grade on search rows (e.g. 99.18 for an A+). |
| accredited, accredited_since | Whether the business is a BBB Accredited Business and the date the profile prints as "BBB Accredited Since". accredited_since is null for a business that is not accredited now, even when BBB keeps an older accreditation date on file (that date stays in dates.accredited). |
| contacts | The owners, principals and managers BBB lists, with prefix, first, middle and last name and title (e.g. Founder, CEO, Owner/Manager). |
| reviews_summary.count, total (reviews) | The business's BBB customer-review count. The reviews total and the profile's count agreed on 24 of 24 businesses. |
| complaints total, count_is_capped | BBB stops counting complaints at 10,000 and serves the first 1,000 pages of 10. counts_by_status and counts_by_type are not capped (Amazon.com: 49,029 answered + 12,261 resolved in the last three years). |
| asterisks in review and complaint text | BBB itself replaces names, numbers and links inside consumer texts with asterisks (*****). The text is returned exactly as BBB publishes it. |
| The business's e-mail as BBB lists it in the contact block (17 of 24 profiles sampled). |
Every search filter was checked on 2026-11-15 by comparing the unfiltered and the filtered count in the same minute; options BBB ignores are not offered.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/bbb/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "plumber",
"location": "Austin, TX"
}
}{
"ok": true,
"meta": {
"api": "bbb",
"endpoint": "search",
"mode": "live",
"latency_ms": 720.3,
"record_count": 15,
"bytes": 54315,
"cache_hit": false,
"total": 2548,
"upstream_requests": 1,
"charged_credits": 1,
"version": "1.0.0",
"request_id": "cc6000c98c144e13",
"queue_ms": 1.1,
"fetched_at": "2026-11-15T22:38:35.271Z"
},
"data": {
"total": 2548,
"total_pages": 15,
"reachable": 225,
"total_is_capped": true,
"page": 1,
"per_page": 15,
"has_more": true,
"rows": [
{
"id": "0825-1000223803",
"bbb_id": "0825",
"business_id": "1000223803",
"address_id": "405686",
"row_id": "0825_1000223803_405686",
"name": "Calixto Plumbing",
"url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803",
"local_report_url": null,
"rating": "A+",
"rating_score": 99.18,
"accredited": true,
"accreditation_status": null,
"is_charity": false,
"charity_seal": false,
"accredited_charity": null,
"address": "8410 Georgian Dr # B",
"city": "Austin",
"state": "TX",
"postal_code": "78753-6003",
"phones": [
"[redacted-phone]"
],
"latitude": 30.3,
"longitude": -97.76,
"distance_miles": null,
"primary_category": {
"id": "10113-000",
"name": "Plumber"
},
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
},
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"logo": "https://m.bbb.org/prod/ProfileImages/2024/1f7a8bd4-fdd2-45ca-8963-5c246e1d3b85.png",
"bbb_office": {
"id": "0825",
"name": "BBB Heart of Texas"
},
"has_service_area": true,
"service_area": null,
"service_area_description": null,
"service_areas_summary": [
"Bell County, TX",
"Burnet County, TX",
"Lee County, TX"
],
"out_of_business_status": null,
"accepts_quote_requests": true,
"request_quote_url": "https://www.bbb.org/central-texas/quote/request-calixto-plumbing-1000223803",
"leave_review_url": "https://www.bbb.org/us/tx/austin/profile/plumber/calixto-plumbing-0825-1000223803/leave-a-review",
"business_login_url": "https://www.bbb.org/central-texas/login",
"score": null
},
{
"id": "0825-1000237688",
"bbb_id": "0825",
"business_id": "1000237688",
"address_id": "445822",
"row_id": "0825_1000237688_445822",
"name": "Abundant Plumbing LLC",
"url": "https://www.bbb.org/us/tx/austin/profile/plumber/abundant-plumbing-llc-0825-1000237688",
"local_report_url": null,
"rating": "A",
"rating_score": 94,
"accredited": true,
"accreditation_status": null,
"is_charity": false,
"charity_seal": false,
"accredited_charity": null,
"address": "PO Box 40698",
"city": "Austin",
"state": "TX",
"postal_code": "78704-0012",
"phones": [
"[redacted-phone]"
],
"latitude": 30.3,
"longitude": -97.76,
"distance_miles": null,
"primary_category": {
"id": "10113-000",
"name": "Plumber"
},
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"logo": "https://m.bbb.org/prod/ProfileImages/2025/604bb2ed-4a9c-46d3-b9f6-22c33a19671f.png",
"bbb_office": {
"id": "0825",
"name": "BBB Heart of Texas"
},
"has_service_area": true,
"service_area": null,
"service_area_description": null,
"service_areas_summary": [
"Hays County, TX",
"Travis County, TX",
"Williamson County, TX"
],
"out_of_business_status": null,
"accepts_quote_requests": true,
"request_quote_url": "https://www.bbb.org/central-texas/quote/request-abundant-plumbing-llc-1000237688",
"leave_review_url": "https://www.bbb.org/us/tx/austin/profile/plumber/abundant-plumbing-llc-0825-1000237688/leave-a-review",
"business_login_url": "https://www.bbb.org/central-texas/login",
"score": null
},
{
"id": "0825-1000194310",
"bbb_id": "0825",
"business_id": "1000194310",
"address_id": "432144",
"row_id": "0825_1000194310_432144",
"name": "Al Mac Plumbing & Gas, LLC",
"url": "https://www.bbb.org/us/tx/austin/profile/plumber/al-mac-plumbing-gas-llc-0825-1000194310",
"local_report_url": null,
"rating": "A+",
"rating_score": 100,
"accredited": true,
"accreditation_status": null,
"is_charity": false,
"charity_seal": false,
"accredited_charity": null,
"address": "10415 Old Manchaca Rd Ste 205 # Suit",
"city": "Austin",
"state": "TX",
"postal_code": "78748-1448",
"phones": [
"[redacted-phone]"
],
"latitude": 30.3,
"longitude": -97.76,
"distance_miles": null,
"primary_category": {
"id": "10113-000",
"name": "Plumber"
},
"categories": [
{
"id": "[trimmed-depth]",
"name": "[trimmed-depth]"
}
],
"logo": "https://m.bbb.org/prod/ProfileImages/2025/983b8958-9f7f-4b1d-b15c-fd154b889909.jpg",
"bbb_office": {
"id": "0825",
"name": "BBB Heart of Texas"
},
"has_service_area": true,
"service_area": null,
"service_area_description": null,
"service_areas_summary": [
"78730",
"78731",
"78732"
],
"out_of_business_status": null,
"accepts_quote_requests": true,
"request_quote_url": "https://www.bbb.org/central-texas/quote/request-al-mac-plumbing-gas-llc-1000194310",
"leave_review_url": "https://www.bbb.org/us/tx/austin/profile/plumber/al-mac-plumbing-gas-llc-0825-1000194310/leave-a-review",
"business_login_url": "https://www.bbb.org/central-texas/login",
"score": null
}
],
"location": {
"id": "Austin_TX_USA",
"display_text": "Austin, TX",
"city": "Austin",
"state": "TX",
"state_name": "Texas",
"country": "US",
"postal_code": "78768",
"postal_codes": [],
"counties": [
"Hays",
"Travis",
"Williamson"
],
"latitude": 30.314613,
"longitude": -97.793745,
"business_count": 46031,
"bbb_office": {
"id": "0825",
"name": "BBB Heart of Texas"
},
"bbb_office_ids": [
"0825"
]
},
"filter_options": {
"categories": [
{
"id": "10113-000",
"name": "Plumber"
},
{
"id": "10113-100",
"name": "Commercial Plumber"
},
{
"id": "10113-300",
"name": "Plumbing Renovation"
}
],
"states": [
"MA",
"TX",
"VA"
]
},
"related_categories": [
{
"name": "Plumber",
"url": "https://www.bbb.org/us/tx/austin/category/plumber"
},
{
"name": "Commercial Plumber",
"url": "https://www.bbb.org/us/tx/austin/category/commercial-plumber"
},
{
"name": "Plumbing Renovation",
"url": "https://www.bbb.org/us/tx/austin/category/plumbing-renovation"
}
],
"sort_options": [
"Relevance",
"Distance",
"Rating"
],
"applied": {
"country": "us",
"sort": "Relevance"
}
}
}What the BBB (Better Business Bureau) API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | 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. | Support teams call search to find businesses on BBB with the site's own filters. | query, location, country, category, state, ... |
| business | 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. | Reputation platforms call business to get one business's full BBB profile. | business |
| reviews | 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). | Market researchers call reviews to get a business's BBB customer reviews. | business, sort, page, per_page |
| complaints | 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. | B2B review analysts call complaints to get a business's BBB complaints, 10 per page. | business, status, type, sort, page |
| business_locations | 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. | Support teams call business_locations to get every location / branch BBB lists for a multi-location business (headquarters, branches, loca…. | business, accredited, page, per_page |
| suggest | 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. | Reputation platforms call suggest to get bBB's own typeahead. | query, type, location, country |
| places | 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`. | Market researchers call places to get bBB's own place typeahead. | query, country, include_postal_codes, limit |
Call search from your stack
curl -X POST https://api.reefapi.com/bbb/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"plumber","location":"Austin, TX"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/bbb/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "plumber",
"location": "Austin, TX"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/bbb/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "plumber",
"location": "Austin, TX"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.bbb.search with {"query":"plumber","location":"Austin, TX"}.Who uses this API and why
- Vet a contractor or supplier: letter grade, accreditation, years in business, licences and complaint history in one call.
- Build a lead list of accredited businesses in a trade and city with phone, owner name and address.
- Monitor new complaints and reviews about your own business or your competitors.
- Score merchants for risk using BBB grade, government-action alerts and complaint counts by type and status.
- Compare complaint types and resolution rates across companies in one industry.
Questions developers ask before integrating
Is there a BBB API?
Yes. The bbb API on ReefAPI returns Better Business Bureau search results, full business profiles, every customer review and every complaint with the business's response for US and Canadian businesses as JSON, read logged out as any visitor sees bbb.org, no BBB account needed.
Which search filters can I use?
The ones BBB's search page offers. Plumbers in Austin, TX on 2026-11-15: 2,548 → accredited 533, grade A 1,276, grade F 20, within 5 miles 43, within 25 miles 401, accepts quote requests 496, serves the area 779, category Sewer Cleaning 225. Nationwide 81,995 plumbers → Texas 5,976, California 12,492.
How many results can one search return?
BBB shows 15 businesses per page and stops at page 15, so one search reaches 225 rows while total gives BBB's full count. Narrow by state, category, grade or distance to reach the rest. Pages 1 to 3 returned 45 different businesses with no repeats.
Can I get every review and every complaint?
Reviews: yes, up to 15 per page and every page (Amazon.com: 4,701 reviews over 314 pages). Complaints: 10 per page up to page 1,000, as BBB serves them, filterable by status and type so each slice can be read separately.
Do I get the owner's name and the business's phone and e-mail?
Yes, when BBB publishes them. In a 24-profile sample: phone 24 of 24, a named owner, principal or manager 24 of 24, website 22 of 24, e-mail 17 of 24, licences 18 of 24, opening hours 12 of 24.
Does it cover Canada?
Yes. Set country=ca: plumbers in Toronto, ON returned 1,315 businesses and roofers in Calgary, AB 1,416 on 2026-11-15.
How do I find a business's BBB id?
Every search row and suggest result carries it (for example 1296-7039385 for Amazon.com). Any bbb.org profile link works as well, including a location page or the reviews and complaints tabs.
How fresh is the data?
Every call reads bbb.org live.
What is the BBB (Better Business Bureau) API?
BBB (Better Business Bureau) API is a ReefAPI endpoint group for bbb letter grades, accreditation, owners, contact details, every customer review and every complaint with the business's reply, for us and canadian businesses. It returns live JSON through POST requests under /bbb/v1.
Is the BBB (Better Business Bureau) API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. BBB (Better Business Bureau) calls use the same shared credit balance as every other ReefAPI engine.
Do I need a BBB (Better Business Bureau) login or account?
No login to BBB (Better Business Bureau) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the BBB (Better Business Bureau) data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the BBB (Better Business Bureau) API use?
BBB (Better Business Bureau) actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call BBB (Better Business Bureau) from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call bbb actions with the same key, credit pool and JSON envelope used by normal REST requests.