Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the BBB (Better Business Bureau) API page →
Reputation & Reviews

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.

7 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

Reference

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.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "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"
  }
}
Captured response
{
  "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"
    }
  }
}
Actions

What the BBB (Better Business Bureau) API does

ActionDescriptionConcrete use caseKey params
searchFind 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, ...
businessOne 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
reviewsA 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
complaintsA 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_locationsEvery 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
suggestBBB'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
placesBBB'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
Code samples

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"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.bbb.search with {"query":"plumber","location":"Austin, TX"}.
Use cases

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.
FAQ

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.

docs / bbb

BBB (Better Business Bureau)

BBB letter grades, accreditation, owners, contact details, every customer review and every complaint with the business's reply, for US and Canadian businesses.

base /bbb/v17 endpoints
post/bbb/v1/business2 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.

ParameterAllowed / rangeDescription
businessrequired—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).
Try in playground →
post/bbb/v1/reviews1 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).

ParameterAllowed / rangeDescription
businessrequired—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 = recentoptionalrecent · highest · lowestrecent (default), highest, lowest.
page = 1optional1–Page, 1-based.
per_page = 15optional1–15Reviews per page, 1-15 (the site's maximum is 15).
Try in playground →
post/bbb/v1/complaints2 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.

ParameterAllowed / rangeDescription
businessrequired—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).
statusoptional—resolved, answered, unresolved, unanswered, unpursuable (the labels work too).
typeoptional—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 = recentoptionalrecent · status · typerecent (default), status, type.
page = 1optional1–1000Page 1-1000 (the site answers up to page 1000).
Try in playground →
post/bbb/v1/business_locations1 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.

ParameterAllowed / rangeDescription
businessrequired—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).
accreditedoptional—Only accredited locations.
page = 1optional1–Page, 1-based.
per_page = 15optional1–15Locations per page, 1-15 (the site's maximum).
Try in playground →
post/bbb/v1/suggest1 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.

ParameterAllowed / rangeDescription
queryrequired—Start of a business or category name (`amaz`, `plumb`).
type = alloptionalall · business · categoryall (default), business or category.
locationoptional—Rank businesses around this place (`Seattle, WA`).
country = usoptionalus · caus (default) or ca.
Try in playground →
post/bbb/v1/places1 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`.

ParameterAllowed / rangeDescription
queryrequired—Start of a city or a ZIP / postal code (`chic`, `6065`, `toron`).
country = usoptionalus · caus (default) or ca.
include_postal_codes = trueoptional—Also match ZIP / postal codes (default true).
limit = 10optional1–10How many, 1-10 (the site's box shows 10).
Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.