API Reference
Use Crawlora's BBB API endpoints to extract supported public BBB data as structured JSON. This documentation covers 9 active endpoints including Get a Better Business Bureau business profile, Get a Better Business Bureau business's complaint history, Get a Better Business Bureau business's full rating reasons and service area, Get a Better Business Bureau business's customer reviews, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as url, id, query, location, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/bbb/search?query=coffee&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/bbb/businessapiKey2 credits/requestReturns 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.
Required params: url:query
/bbb/business/complaintsapiKey2 credits/requestReturns 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.
Required params: url:query
/bbb/business/more-infoapiKey2 credits/requestReturns 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.
Required params: url:query
/bbb/business/reviewsapiKey2 credits/requestReturns 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.
Required params: url:query
/bbb/categoryapiKey2 credits/requestBrowses 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.
Required params: url:query
/bbb/scamtracker/{id}apiKeyNo listed credit chargeReturns 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.
Required params: id:path
/bbb/scamtracker/searchapiKey2 credits/requestSearches 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.
Required params: None
/bbb/scamtracker/state-statsapiKey2 credits/requestReturns 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.
Required params: None
/bbb/searchapiKey2 credits/requestSearches 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.
Required params: query:query, location:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Get a Better Business Bureau business profile | /bbb/business | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get a Better Business Bureau business's complaint history | /bbb/business/complaints | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get a Better Business Bureau business's full rating reasons and service area | /bbb/business/more-info | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get a Better Business Bureau business's customer reviews | /bbb/business/reviews | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Browse a Better Business Bureau category | /bbb/category | GET | 2 credits/request | url:query | View docs | Try endpoint |
| Get a Better Business Bureau Scam Tracker report | /bbb/scamtracker/{id} | GET | No listed credit charge | id:path | View docs | Try endpoint |
| Search Better Business Bureau Scam Tracker reports | /bbb/scamtracker/search | GET | 2 credits/request | None | View docs | Try endpoint |
| Get Better Business Bureau Scam Tracker state/province aggregate stats | /bbb/scamtracker/state-stats | GET | 2 credits/request | None | View docs | Try endpoint |
| Search Better Business Bureau businesses | /bbb/search | GET | 2 credits/request | query:query, location:query | View docs | Try endpoint |