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
Crawlora's BBB API is designed around BBB's own data surface, not a generic fetch endpoint — combining endpoint-specific request logic, managed infrastructure, parsing, normalization, billing, and Playground-tested examples.
Request behavior for BBB endpoints is tuned to the platform's own response shapes and edge cases.
Supported BBB endpoints can use managed proxy routing to improve reliability and reduce infrastructure work.
Dynamic BBB pages can be routed through managed browser instances where JavaScript rendering is required.
Challenge pages and unusable BBB responses are detected and surfaced clearly, not silently returned as empty data.
BBB results are returned as documented JSON instead of raw HTML.
Test the same BBB route from Docs and Playground before production integration.
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.
/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.
/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.
/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.
/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.
/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.
/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.
/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.
/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.
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.