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.
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.
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.
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.
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. If BBB merges a story into another BBB article, the response contains the target article's id and source_url plus the original requested_url. Returns a permanent 404 when BBB moves the URL to an evergreen /all/ page or outside bbb.org, when BBB redirects the URL back to itself so it cannot be loaded, or when the URL resolves to a published non-article type such as an event; safe HTTPS destinations are named in the error and are never fetched.
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.
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.
客户端库
为你的语言安装 Better Business Bureau 专用客户端。每个包都覆盖本页的 Better Business Bureau 端点，并使用你的 API 密钥调用 Crawlora 托管 API。
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/bbbPackagistcargo add crawlora-bbbcrates.ioFAQ
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.