Vendor and supplier trust vetting
Use BBB endpoints to turn vendor and supplier trust vetting into repeatable API requests with documented inputs and JSON responses.
Turn public Better Business Bureau (bbb.org) pages into structured JSON — search or browse businesses by category and location, resolve a full business profile with its rating, accreditation, and contact detail, and pull a business's complaint history with response threads. Credential-free.
Search Better Business Bureau businesses, get a rating/accreditation profile and complaint history, and browse by category as structured JSON.
Endpoint families
6
Documented params
76
Examples
17
Live catalog snapshot
Active endpoints
17
Methods
GET
Required params
32
Schema refs
17
{
"platform": "BBB",
"endpoint": "bbb-search",
"method": "GET",
"path": "/bbb/search",
"auth": "apiKey"
}Use cases
Search Better Business Bureau businesses, get a rating/accreditation profile and complaint history, and browse by category as structured JSON.
Use BBB endpoints to turn vendor and supplier trust vetting into repeatable API requests with documented inputs and JSON responses.
Use BBB endpoints to turn local business research and lead qualification into repeatable API requests with documented inputs and JSON responses.
Use BBB endpoints to turn complaint and dispute monitoring into repeatable API requests with documented inputs and JSON responses.
Managed execution
Every figure below is read from the live BBB endpoint catalog — 17 endpoints, 76 documented request parameters, and 17 published response schemas — the same catalog Docs and Playground run against.
17 documented BBB endpoints, grouped into 10 request families — Business, Scamtracker and News, plus 7 more.
76 request parameters are documented across those BBB endpoints, 32 of them required — the full input contract is public before you write any integration code.
17 of the 17 BBB endpoints ship a recorded example response, and 17 carry a documented response schema — you can code against the real JSON before the first request.
BBB endpoints document their error responses (400, 404, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
17 hosted MCP tools back the BBB endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Coverage map
/bbb/business
/bbb/scamtracker/{id}
/bbb/news
/bbb/search
/bbb/article
/bbb/category
Featured endpoints
/bbb/searchSearches bbb.org for businesses by name or category near a location. Returns each business's BBB rating letter grade, accreditation status, categories, service areas, contact info, and profile URL. A verified empty first page returns results: [] and total_results: 0; an unavailable or unrecognized page returns an error. A page beyond the exact last page returns 404, and a page beyond BBB's 15-page accessible limit returns 404 naming that limit. Category IDs and state/province codes are query-scoped; call bbb-search-filters to discover values for this query and location.
Sampled 14 Oct 2026: 15 items, 8 fields filled in every item, 3 not. rating: A+ (12), A (3); name: “Calixto Plumbing” and 13 other values.
MCP tool bbb_search
/bbb/businessReturns a bbb.org business profile: BBB rating letter grade and reasons, accreditation status and since-date, years in business, BBB file/incorporation dates, entity type, contact info, business categories, social media, and a short latest-reviews preview.
Sampled 14 Oct 2026: 7 items, 2 fields filled in every item. hours: 7:00 AM - 4:00 PM (6), Closed (1); day: “Monday” and 6 other values.
MCP tool bbb_business
/bbb/business/complaintsReturns a business's BBB complaint history: total complaint count, complaints closed or filed in the last 12 months, and one page of per-complaint detail (date, type, status, narrative text, and any business response / customer answer thread). Complaints are listed newest first, 10 per page; use page with the returned page, total_pages and has_more to walk the full list. A business with no filed complaints returns total_complaints 0 and an empty complaints list -- this is a normal result, not an error.
Sampled 14 Oct 2026: 7 of 8 fields returned with a value. total_complaints: 0; business_name: “Calixto Plumbing”.
MCP tool bbb_business_complaints
/bbb/categoryBrowses bbb.org businesses by category and location directly, without a free-text search query. Returns the same business-result shape as bbb-search. A verified empty first page returns results: [] and total_results: 0; an unavailable or unrecognized page returns an error. A page beyond the exact last page returns 404, and a page beyond BBB's 15-page accessible limit returns 404 naming that limit. Optional sort and filter parameters use the same values as bbb-search; query-scoped category and state/province values come from bbb-search-filters.
Sampled 14 Oct 2026: 15 items, 8 fields filled in every item, 3 not. rating: A+ (12), A (3); name: “Team Flo-Right LLC” and 13 other values.
MCP tool bbb_category
/bbb/articleReturns published BBB article metadata, author names, body text, and useful links from a canonical public article URL on www.bbb.org or bbb.org. Returns 404 when BBB no longer has the article, including a story BBB has moved to one of its evergreen pages under /all/; the error then names the new address, and the answer is permanent.
Sampled 14 Oct 2026: 3 items, 2 fields filled in every item. url: bbb.org and 1 other host; text: median 21 characters.
MCP tool bbb_article
/bbb/business/more-infoReturns a business's full per-factor "Reasons for Rating" list and full service-area list. The bbb-business endpoint's own rating_reasons field typically holds only one generic boilerplate bullet regardless of actual rating; this endpoint returns the richer, business-specific list instead. Service area is business-conditional -- some businesses render no service-area section at all, in which case service_areas is empty.
Sampled 14 Oct 2026: 4 of 4 fields returned with a value. business_name: “Calixto Plumbing”; rating_reasons: 1 entry.
MCP tool bbb_business_more_info
Related APIs
Reviews & Reputation
Use a Trustpilot reviews API to monitor review volume, star ratings, and customer feedback across companies and categories as structured JSON for reputation tracking, competitor analysis, and review intelligence workflows.
Reviews & Reputation
Search Yelp businesses by term and location and get normalized JSON results — ratings, review counts, categories, address, coordinates, and photos — for local business discovery, competitor research, and reputation monitoring.
Reviews & Reputation
Turn public Capterra software listings and reviews into normalized JSON for software discovery, competitor research, review analysis, and product enrichment. Search by category or keyword, resolve a product, then page through its public reviews without maintaining a scraper.
How to scrape BBB
Crawlora's BBB endpoints turn bbb.org's business directory into structured JSON with one API key — no BBB account or login required.
Search by business name or category near a location, or browse a category directly using a related-category URL from a search result.
Pass a result's profile URL to the business endpoint for the full BBB rating, accreditation status, and contact detail.
Pass the same profile URL to the complaints endpoint for filed complaints, their status, and any business-response threads.
Use a result's hq_profile_url instead of url when its rating is inherited from a headquarters listing.
Client libraries
Install the dedicated Better Business Bureau client for your language. Each package covers the Better Business Bureau endpoints on this page and calls Crawlora's hosted API with your API key.
npm install @crawlora-org/bbbnpmpip install crawlora-bbbPyPIgo get github.com/Crawlora-org/crawlora-bbbpkg.go.devgem install crawlora-bbbRubyGemsnet.crawlora:crawlora-bbbMaven Centralcomposer require crawlora/bbbPackagistFAQ
Send a business name or category keyword plus a city/state or ZIP to Crawlora's /bbb/search endpoint and get normalized results back — rating, accreditation, categories, contact info — as structured JSON.
No. These endpoints read bbb.org's public business directory and require only your Crawlora API key.
Yes — pass a business's profile URL to /bbb/business/complaints for its filed complaint count, individual complaint entries, and any business-response threads, as structured JSON.
No. BBB doesn't offer a general-purpose data API — Crawlora's endpoints read the same public profile and complaint pages a website visitor sees.