BBB (Better Business Bureau) API

Every BBB business, with its grade, its owners, its reviews and its complaints

endpoints
7
credits per call
1–2

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.

POST/bbb/v1/search
Real result, captured Nov 15, 20263 of 15
address_idratingnameaddress
405686A+Calixto Plumbing8410 Georgian Dr # B
445822AAbundant Plumbing LLCPO Box 40698
432144A+Al Mac Plumbing & Gas,…10415 Old Manchaca Rd S…
7 active endpoints, on 1 and 2 credit tiers.search · business · reviews · complaints · business_locations · suggest+1 more ↓OpenAPI 3.0 spec ↗

1 credit per call≈ $1/1,000 calls1,000 free credits, no card

Get a free API key
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

BBB (Better Business Bureau) API

5 of 7 endpoints, ready to run

View docs ↗

Businesses by trade and place, with BBB's filters

1 credit0 required · 4 optional
POST/bbb/v1/search
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What BBB (Better Business Bureau) endpoints does ReefAPI ship?

7 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

  • search

    1 cr

    Find businesses on BBB with the site's own filters.

    required
    —
    optional
    query, location, country, category, state, rating, accredited, distance, quote_requests_only, serving_area_only, sort, page
  • business

    2 cr

    One business's full BBB profile.

    required
    business
    optional
    —
  • reviews

    1 cr

    A business's BBB customer reviews.

    required
    business
    optional
    sort, page, per_page
  • complaints

    2 cr

    A business's BBB complaints, 10 per page.

    required
    business
    optional
    status, type, sort, page
  • business_locations

    1 cr

    Every location / branch BBB lists for a multi-location business (headquarters, branches, loca…

    required
    business
    optional
    accredited, page, per_page
  • suggest

    1 cr

    BBB's own typeahead.

    required
    query
    optional
    type, location, country
  • places

    1 cr

    BBB's own place typeahead.

    required
    query
    optional
    country, include_postal_codes, limit

Every parameter, every allowed value →

Missing a BBB (Better Business Bureau) endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the BBB (Better Business Bureau) API works

BBB (Better Business Bureau) is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

Authenticate01
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

Call02
POST /bbb/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

Pay03
1 or 2 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

Read04
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From a trade and a city to a vetted shortlist

Search with BBB's filters, open the profiles you want, then read what customers reported.

01search?query=plumber&location=Austin%2C%20TX&accredited=true&rating=A
GET/bbb/v1/search?query=plumber&location=Austin%2C%20TX&accredited=true&rating=A

Accredited A-grade plumbers in Austin: BBB id, address, phone, grade, rating score, categories and service-area counties per row; 533 accredited of 2,548 on 2026-11-15.

02business?business=<id>
GET/bbb/v1/business?business=<id>

Grade with BBB's reasons, accredited since, years in business, owners and principals, phones, e-mail, website, hours, licences and alerts.

03complaints?business=<id>&status=unresolved
GET/bbb/v1/complaints?business=<id>&status=unresolved

Unresolved complaints with type, date, the consumer's text and every reply, plus the business's counts per status and type.

04reviews?business=<id>&sort=lowest
GET/bbb/v1/reviews?business=<id>&sort=lowest

The lowest-rated customer reviews first, with the business's response.

A dated shortlist where every business carries its BBB grade, its accreditation, who owns it and what its customers reported.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "bbb",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat it holds
search rowsOne 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.
ratingBBB'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_scoreBBB's numeric score behind the letter grade on search rows (e.g. 99.18 for an A+).
accredited, accredited_sinceWhether 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).
contactsThe 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_cappedBBB 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 textBBB itself replaces names, numbers and links inside consumer texts with asterisks (*****). The text is returned exactly as BBB publishes it.
emailThe 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.

Coverage

BBB coverage, measured

Every number below was read from live bbb.org on 2026-11-15 and 2026-11-16.

United States

Plumbers alone: 81,995 nationwide, 5,976 in Texas, 12,492 in California, 2,548 around Austin, TX.

Canada

country=ca: plumbers around Toronto, ON 1,315, roofers around Calgary, AB 1,416.

Filters that bite

Plumbers in Austin, TX 2,548 → accredited 533, grade A 1,276, grade F 20, within 5 miles 43, within 100 miles 1,420, accepts quote requests 496, serves the area 779, category Sewer Cleaning 225.

Paging

15 businesses per page and 15 pages (225 rows) per search, as BBB serves them; reviews 15 per page with every page reachable; complaints 10 per page up to page 1,000.

Accuracy

Review totals matched the profile's review count on 24 of 24 businesses; search rows matched their location's own BBB page on street, city, state, phone and grade 12 of 12; every complaint returned by a status or type filter carried that status or type.

Limits

One search reaches 225 rows. BBB counts complaints up to 10,000 per business (the per-status and per-type counts are not capped). Names and numbers inside consumer texts arrive masked with asterisks by BBB itself.

Use cases

What people build with BBB (Better Business Bureau)

The jobs this data is most often used for.

01

Vet a contractor or supplier: letter grade, accreditation, years in business, licences and complaint history in one call.

02

Build a lead list of accredited businesses in a trade and city with phone, owner name and address.

03

Monitor new complaints and reviews about your own business or your competitors.

04

Score merchants for risk using BBB grade, government-action alerts and complaint counts by type and status.

7

endpoints

1/2

credits per call

Pricing

What BBB (Better Business Bureau) data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up BBB (Better Business Bureau).

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.

Same key

17 Reputation & Reviews APIs on the same key

One key, one credit pool, one response envelope. If you are pulling BBB (Better Business Bureau), you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.