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
4
Documented params
30
Examples
9
Live catalog snapshot
Active endpoints
9
Methods
GET
Required params
17
Schema refs
9
{
"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 — 9 endpoints, 30 documented request parameters, and 9 published response schemas — the same catalog Docs and Playground run against.
9 documented BBB endpoints, grouped into 4 request families — Business, Scamtracker and Category, plus 1 more.
30 request parameters are documented across those BBB endpoints, 17 of them required — the full input contract is public before you write any integration code.
9 of the 9 BBB endpoints ship a recorded example response, and 9 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.
9 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
These cards are generated from the active endpoint catalog, so the landing page reflects the same API surface used by Docs and Playground.
/bbb/business
/bbb/scamtracker/{id}
/bbb/category
/bbb/search
Endpoint catalog
/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. Credential-free public Better Business Bureau data.
MCP tool bbb_search
/bbb/businessReturns a normalized 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. Credential-free public Better Business Bureau data.
MCP tool bbb_business
/bbb/business/complaintsReturns a business's BBB complaint history: total complaint count, complaints closed in the last 12 months, and per-complaint detail (date, type, status, narrative text, and any business response / customer answer thread). A business with no filed complaints returns total_complaints 0 and an empty complaints list -- this is a normal result, not an error. Credential-free public Better Business Bureau data.
MCP tool bbb_business_complaints
/bbb/categoryBrowses bbb.org businesses by category and location directly, without a free-text search query. Returns the same normalized business-result shape as bbb-search. Credential-free public Better Business Bureau data.
MCP tool bbb_category
/bbb/business/more-infoReturns a business's full per-factor "Reasons for Rating" list and full service-area list, from the separate BBB business profile /more-info sub-page. The bbb-business endpoint's own rating_reasons field is read from the main profile page and typically holds only one generic boilerplate bullet regardless of actual rating; this endpoint fetches 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. Credential-free public Better Business Bureau data.
MCP tool bbb_business_more_info
/bbb/business/reviewsReturns a business's full customer-review list (author, star rating, date, text, and any business response thread), paginated 10 per page, plus the average star rating and total review count. Credential-free public Better Business Bureau data. Unlike the other bbb-business-* endpoints, this one is fetched with browser impersonation rather than plain direct HTTP -- see the family's maintenance note for why.
MCP tool bbb_business_reviews
/bbb/scamtracker/{id}Returns one normalized BBB Scam Tracker consumer scam report: description, dollars lost, targeted person's location, scammer location/email/phone/URL (when known), scam type, business name used, and date reported. Credential-free public Better Business Bureau data.
MCP tool bbb_scamtracker_detail
/bbb/scamtracker/searchSearches bbb.org Scam Tracker's consumer-reported-scam database by free-text query, scam category, targeted-victim state/province, reported-scammer state/province, report-date range, and/or dollar-loss range, paginated 10 results/page. Omit every filter to browse the most-recent-first feed. Credential-free public Better Business Bureau data. This is a separate BBB dataset from the bbb-search/bbb-business/bbb-business-complaints business-rating family -- consumer-reported scam incidents, not business ratings.
MCP tool bbb_scamtracker_search
/bbb/scamtracker/state-statsReturns aggregate scam-report stats per US state and Canadian province for a given time window: report counts, dollar losses, per-capita rates, year-over-year change, and top scam-type breakdown. This calls the same JSON API the BBB Scam Tracker heatmap dashboard's own frontend uses -- not an HTML scrape. Credential-free public Better Business Bureau data.
MCP tool bbb_scamtracker_state_stats
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.
FAQ
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.