GET/bbb/articleapiKey2 credits/request
Returns 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.
Required: url.
Sampled 14 Oct 2026: 3 items. Filled in every item: text, url. In the sample: url: bbb.org and 1 other host; text: median 21 characters.
Open in Playground
GET/bbb/businessapiKey3 credits/request
Returns 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.
Required: url.
Sampled 14 Oct 2026: 7 items. Filled in every item: day, hours. In the sample: hours: 7:00 AM - 4:00 PM (6), Closed (1); day: “Monday” and 6 other values.
Open in Playground
GET/bbb/business/complaintsapiKey5 credits/request
Returns 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.
Required: url. Optional: page.
Sampled 14 Oct 2026: 7 fields returned with a value, 1 empty (complaints). In the sample: total_complaints: 0; business_name: “Calixto Plumbing”; submit_complaint_url: bbb.org; has_more: false; published_complaints: 0; hidden_complaints: 0.
Open in Playground
GET/bbb/business/more-infoapiKey3 credits/request
Returns 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.
Required: url.
Sampled 14 Oct 2026: 4 fields returned with a value. In the sample: business_name: “Calixto Plumbing”; rating_reasons: 1 entry; rating: “A+”; service_areas: 6 entries.
Open in Playground
GET/bbb/business/reviewsapiKey3 credits/request
Returns 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.
Required: url. Optional: page.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, author, rating, date, text, responses. In the sample: date: 2025-02-04 to 2026-06-02; rating: 1 to 5, median 2; text: median 449 characters; responses: median 1 entry.
Open in Playground
GET/bbb/categoryapiKey3 credits/request
Browses 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.
Required: url. Optional: page, sort (5 allowed values: Relevance, Distance, Rating, AToZ, ZToA), distance (5 allowed values: 5, 10, 25, 50, 100), rating, category_id, state, accredited, get_quote, service_area.
Sampled 14 Oct 2026: 15 items. Filled in every item: name, url, categories, rating, accredited, phone, address, service_areas. Not in every item: image_url (11), quote_url (14), hq_profile_url (2). In the sample: rating: A+ (12), A (3); name: “Team Flo-Right LLC” and 13 other values; url: bbb.org; accredited: true in 15 of 15; categories: median 3 entries; image_url: m.bbb.org; service_areas: median 6 entries; quote_url: bbb.org.
Open in Playground
GET/bbb/local-bbbapiKey2 credits/request
Returns public chapter profile details including office locations and hours, service territory, supported languages, and upcoming public events. news_url is the chapter's constructed newsroom route. When BBB publishes a program tile linking to a recognized newsroom path, published_news_url and its descriptive published_news_title are also returned. Use a canonical chapter URL from bbb-local-bbbs or a business record's local_bbb_url.
Required: url.
Sampled 14 Oct 2026: 3 items. Filled in every item: title, url, summary, starts_at, ends_at. In the sample: starts_at: 2026-10-15 to 2026-10-23; title: “She Means Business: Building the Plane While Flying” and 2 other values; url: bbb.org; summary: median 153 characters; ends_at: 2026-10-15 to 2026-10-23.
Open in Playground
GET/bbb/local-bbbsapiKey2 credits/request
Lists every chapter and public office shown on BBB's directory page for a region discovered by bbb-regions. Office addresses can be outside the selected service region.
Required: country (2 allowed values: us, ca), region.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, name, url, news_url, open_to_public, offices. In the sample: name: “BBB Heart of Texas” and 9 other values; url: bbb.org; open_to_public: true in 10 of 10; offices: median 1 entry; news_url: bbb.org.
Open in Playground
GET/bbb/newsapiKey2 credits/request
Returns one page of BBB newsroom cards from a canonical BBB newsroom URL. Three scopes are accepted, each with an optional topic: the US or Canada newsroom (/us/news), a state, province or city newsroom (/us/ca/news, /us/ca/san-francisco/news), and one local BBB chapter's own newsroom (/local-bbb/<chapter>/news, the news_url returned by bbb-local-bbbs and bbb-local-bbb). The list is whatever BBB shows on that page: a city or chapter whose local BBB publishes its own stories returns those, and other cities, other chapters and the state pages checked so far return the same list as the country newsroom, so compare total and the first items with the country newsroom before treating a list as local. A chapter URL also returns local_bbb_id and local_bbb_name. Items preserve BBB's type and include Article stories, events, and Near Me related-service cards when present. Near Me URLs are restricted to BBB's /near-me/<slug> paths. Every page carries total_pages and has_more: request page + 1 while has_more is true and stop when it is false; a page past the end returns 404. Event dates and links are preserved when present.
Required: url.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, title, type, url, summary, modified_date, image. In the sample: modified_date: 2024-09-11 to 2026-10-06; url: bbb.org; title: median 71 characters; summary: median 134 characters.
Open in Playground
GET/bbb/news/topicsapiKey1 credit/request
Returns the complete topic navigation shown by a BBB newsroom page, including its active topic. The page can be the US or Canada newsroom, a state, province or city newsroom, or one local BBB chapter's newsroom; the returned topic URLs stay in that scope, and a chapter has its own topic set.
Required: url.
Sampled 14 Oct 2026: 10 items. Filled in every item: name, slug, url. In the sample: name: “Business” and 9 other values; url: bbb.org.
Open in Playground
GET/bbb/pageapiKey2 credits/request
Returns one page from the evergreen library BBB keeps under https://www.bbb.org/all/ (tips, topic hubs such as tax or holiday advice, scam studies): its title, introduction, body text, links, main image and last-modified time. BBB folds older newsroom stories into these pages and redirects the old article URL, so the url can be either the evergreen page itself or an article URL that bbb-article reports as moved; requested_url, final_url and every redirect between them are returned. published_at is always present and is null, because BBB publishes no date for these pages: modified_at is when BBB last edited the page, not when a story it replaced was published, and the page may cover a wider topic than that story did. The original article ID is not on the page; article_id repeats the one in the requested article URL. Returns 404 when the page does not exist, when an article URL has not been moved (read it with bbb-article), and when BBB redirects the URL somewhere outside /all/; the error names the destination and the answer is permanent. Content BBB loads in the browser for the visitor's local BBB is not included.
Required: url.
Sampled 14 Oct 2026: 21 items. Filled in every item: text, url. In the sample: text: “United States” and 20 other values; url: bbb.org and 2 other hosts.
Open in Playground
GET/bbb/regionsapiKey1 credit/request
Returns the complete current country and region list from BBB's public local directory. Use the returned region code with bbb-local-bbbs.
Takes no parameters.
Sampled 14 Oct 2026: 2 items. Filled in every item: code, name, regions. In the sample: name: “United States” and 1 other value; regions: median 12 entries.
Open in Playground
GET/bbb/scamtracker/{id}apiKeyNo listed credit charge
Returns one 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.
Required: id.
Sampled 14 Oct 2026: 11 fields returned with a value. In the sample: dollars_lost: “$149”; description: 137 characters; targeted_location: “Chesapeake, VA, USA - 23322”; scammer_location: “GA”; scammer_url: “Unknown URL”; scam_type: “Online Purchase”; business_name: “AltRX”; date_reported: “August 19, 2026”.
Open in Playground
GET/bbb/scamtracker/searchapiKey5 credits/request
Searches 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. A verified search with no matches returns results: [] and total_results: 0; an unavailable or unrecognized page returns 503 rather than an empty list. When result cards are present but BBB's total count is unavailable, total_results is omitted. Every page returns has_more and, when BBB's result count is exact, total_pages: request the next page only while has_more is true, because a page past the end returns 404. Omit every filter to browse the most-recent-first feed. 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.
Optional: query, scam_type (37 allowed values: Advance Fee Loan, Bank/Credit Card Company Imposter, Business Email Compromise, Charity, Counterfeit Product, COVID-19, Credit Cards, Credit Repair/Debt Relief, CryptoCurrency, Debt Collections, Employment, Fake Check/Money Order, Fake Invoice/Supplier Bill, Family/Friend Emergency, Foreign Money Exchange, Government Agency Imposter, Government Grant, Healthcare/Medicaid/Medicare, Home Improvement, Identity Theft, Investment, Moving, Online Purchase, Other, Phishing, Rental, Retail Business, Romance, Scholarship, Sweepstakes/Lottery/Prizes, Tax Collection, Tech Support, Travel/Vacation/Timeshare, Utility, Vanity Award, Worthless Problem-solving Service, Yellow Pages/Directories), state, scammer_state, date_from, date_to, min_dollars_lost, max_dollars_lost, page.
Sampled 14 Oct 2026: 10 items. Filled in every item: id, category, description, dollars_lost, victim_location, date_reported, business_name_used, url. In the sample: dollars_lost: $0.0 (7), $205.66 (1), $680 (1) and 1 more; category: “Fake Invoice/Supplier Bill - Amazon Pretender” and 7 other values; url: bbb.org; description: median 393 characters; victim_location: “TX, USA - 75702” and 9 other values; date_reported: “January 26, 2021” and 9 other values; business_name_used: Amazon (9), amazon (1).
Open in Playground
GET/bbb/scamtracker/state-statsapiKey2 credits/request
Returns 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.
Optional: period (4 allowed values: 30, 90, 365, all).
Sampled 14 Oct 2026: 64 items. Filled in every item: country, code, name, reports, reports_with_loss, pct_reporting_loss, losses, median_loss and 6 more. In the sample: country: USA (51), CAN (13); reports: 1 to 5,008, median 524; name: “Alberta” and 63 other values; scam_type_breakdown: median 8 entries; reports_with_loss: 0 to 2,706, median 288; pct_reporting_loss: 0 to 100, median 53; losses: 0 to 3,542,956, median 376,216; median_loss: 0 to 443, median 83.
Open in Playground
GET/bbb/searchapiKey2 credits/request
Searches 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.
Required: query, location. Optional: page, country (2 allowed values: USA, CAN), sort (5 allowed values: Relevance, Distance, Rating, AToZ, ZToA), distance (5 allowed values: 5, 10, 25, 50, 100), rating, category_id, state, accredited, get_quote, service_area.
Sampled 14 Oct 2026: 15 items. Filled in every item: name, url, categories, rating, accredited, phone, address, service_areas. Not in every item: image_url (11), quote_url (14), hq_profile_url (2). In the sample: rating: A+ (12), A (3); name: “Calixto Plumbing” and 13 other values; url: bbb.org; accredited: true in 15 of 15; categories: median 4 entries; image_url: m.bbb.org; service_areas: median 6 entries; quote_url: bbb.org.
Open in Playground
GET/bbb/search/filtersapiKey1 credit/request
Returns the live sort, category, and state/province values BBB currently advertises for one context. Supply query and location for text search, or category_url for the exact category-browse context; do not combine these modes. Category IDs and state/province codes are query-scoped; call this endpoint again when the search context changes. Static accepted values are country USA or CAN; sort Relevance, Distance, Rating, AToZ, or ZToA; distance 5, 10, 25, 50, or 100 miles; rating A, B, C, D, or F.
Optional: query, location, category_url, country (2 allowed values: USA, CAN), page, sort (5 allowed values: Relevance, Distance, Rating, AToZ, ZToA), distance (5 allowed values: 5, 10, 25, 50, 100), rating, category_id, state, accredited, get_quote, service_area.
Sampled 14 Oct 2026: 3 items. Filled in every item: value, label. In the sample: value: “MA” and 2 other values; label: “MA” and 2 other values.
Open in Playground