Primary category
primaryCategory
Optional
Main BBB category.
BBB Businesses Scraper
Pricing
from $0.62 / 1,000 businesses
BBB scraper for the Better Business Bureau (bbb.org): businesses in the US and Canada with name, BBB rating, accreditation, phone, address and category, plus optional full profile, reviews, complaints and the email found on the company website. Export to JSON, CSV or Excel.
ID
id
Required
BBB business key <bbbId>-<businessId> (stable, unique).
Business ID
businessId
Required
BBB business id (second number of the profile URL).
Local BBB ID
bbbId
Required
Id of the local BBB office that files the business (first number of the profile URL).
BBB profile URL
url
Required
Public BBB business profile.
Business name
name
Required
Name of the business on its BBB profile (Full business profile option). Otherwise the name the search lists, highlighting removed (BBB can list a business under another of its names); for a branch of a chain found in the directory or by its URL, BBB gives no name there: it is spelled from its profile URL.
Phone
phone
Optional
Main phone number as shown by BBB.
Phone (international)
phoneE164
Optional
Main phone in international E.164 format, ready for a dialer or CRM.
Full address
address
Optional
Street, city, state and ZIP in one line.
Street
street
Optional
Street address.
City
city
Optional
City.
State / province
state
Optional
Two-letter state or province code.
ZIP / postal code
postalCode
Optional
ZIP or postal code.
Country
country
Optional
USA or CAN.
Latitude
latitude
Optional
Latitude of the business, to 6 decimals (search results and Full business profile; null from the directory or a pasted URL without it).
Longitude
longitude
Optional
Longitude of the business, to 6 decimals (search results and Full business profile; null from the directory or a pasted URL without it).
BBB rating
bbbRating
Optional
BBB letter grade A+ to F, or NR (not rated), as its profile prints it. null for a branch of a chain found in the directory or by its URL without the Full business profile option (BBB gives no grade there).
BBB rating score
ratingScore
Optional
BBB score behind the letter grade, 0-100 (search results only; null from the directory, a category page and a pasted business URL).
BBB Accredited
isAccredited
Optional
True when the business is BBB Accredited.
Primary category
primaryCategory
Optional
Main BBB category.
Categories
categories
Required
All BBB categories of the business (a business read from the directory or a pasted URL has them only with Full business profile; otherwise [], and primaryCategory is the category of its URL).
[ "Plumber", "Plumbing Renovation", "Commercial Plumber"]Category IDs
categoryIds
Required
BBB category ids, same order as categories (first = primary category); the profile page gives the id of the primary category only.
[ "10113-000", "10113-300", "10113-100"]Service areas
serviceAreas
Required
Areas the business serves, as listed by BBB.
[ "Travis County, TX", "Williamson County, TX"]Has service area
hasServiceArea
Optional
True when the business declares a service area on BBB.
Distance (miles)
distanceMiles
Optional
Distance from the searched location in miles, as computed by BBB (search results with a location only).
Logo URL
logoUrl
Optional
Business logo image.
Local BBB
localBbb
Optional
Name of the local BBB office.
Local BBB URL
localBbbUrl
Optional
Page of the local BBB office on bbb.org (Full business profile option; null otherwise).
Location profile URL
locationUrl
Optional
BBB page of this exact address when the business has several locations (search results only; null otherwise).
Accepts quote requests
acceptsQuoteRequests
Optional
Takes quote requests through BBB ("Get a Quote"). null when unknown: a business found in the directory or by its URL, without the Full business profile option.
Quote request URL
requestAQuoteUrl
Optional
BBB quote request page.
Leave a review URL
leaveReviewUrl
Optional
BBB page where customers leave a review.
Reviews page URL
reviewsUrl
Optional
BBB customer reviews page of the business.
Complaints page URL
complaintsUrl
Optional
BBB complaints page of the business.
Charity
isCharity
Optional
True for a charity profile.
Charity seal
charitySeal
Optional
True when the charity shows the BBB Wise Giving Alliance seal.
Accredited charity
accreditedCharity
Optional
BBB Wise Giving Alliance accredited charity.
Out of business
outOfBusiness
Optional
True when BBB marks the business as out of business.
Other names
alternateNames
Required
Other business names (DBA, former names) (Full business profile option; [] otherwise).
[ "Calixto Plumbing LLC"]Website
website
Optional
Company website (Full business profile option; null otherwise).
Website domain
websiteDomain
Optional
Domain of the company website, without www. (Full business profile option; null otherwise).
Other websites
additionalWebsites
Required
Other websites (Full business profile option; [] otherwise).
[]Optional
Business email shown by BBB, decoded (Full business profile option; null otherwise).
Other emails
additionalEmails
Required
Other emails shown by BBB (Full business profile option; [] otherwise).
[]Emails from the website
websiteEmails
Required
Emails found on the company website (Email from the company website option; empty otherwise).
[ "service@calixtoplumbing.com"]Email source page
emailSource
Optional
Website page where the first website email was found (Email from the company website option).
Other phones
additionalPhones
Required
Other phone numbers (search results or profile). A search result can list a fax among them: with Full business profile, faxes are in faxNumbers only.
[ "(512) 555-0100"]Fax numbers
faxNumbers
Required
Fax numbers (Full business profile option; [] otherwise).
[]Contacts
contacts
Required
Owners and managers named by BBB: {name, title, isPrincipal} (Full business profile option; [] otherwise).
[ { "name": "Juan Calixto", "title": "Owner", "isPrincipal": true }]Owner name
ownerName
Optional
First principal contact (Full business profile option; null otherwise).
Owner title
ownerTitle
Optional
Title of the first principal contact (Full business profile option; null otherwise).
Licenses
licenses
Required
Licenses listed by BBB: {number, agency, agencyPhone, agencyUrl, status, expiration, type} (Full business profile option; [] otherwise).
[ { "number": "M-12345", "agency": "Texas State Board of Plumbing Examiners", "agencyPhone": "(512) 936-5200", "agencyUrl": null, "status": null, "expiration": null, "type": null }]Opening hours
openingHours
Required
Opening hours per day: {day, open, close, note}; note is what BBB writes instead of hours (Closed, Open 24 Hours) (Full business profile option; [] otherwise).
[ { "day": "Monday", "open": "08:00", "close": "17:00", "note": null }, { "day": "Sunday", "open": null, "close": null, "note": "Closed" }]Description
description
Optional
Business description written for BBB (Full business profile option; null otherwise).
Products and services
productsAndServices
Optional
Products and services summary (Full business profile option; null otherwise).
Payment methods
paymentMethods
Required
Accepted payment methods (Full business profile option; [] otherwise).
[ "Visa", "Check"]Legal form
entityType
Optional
Type of entity (LLC, corporation, sole proprietor…) (Full business profile option; null otherwise).
Employees
numberOfEmployees
Optional
Number of employees declared to BBB (Full business profile option; null otherwise).
Years in business
yearsInBusiness
Optional
Years in business (Full business profile option; null otherwise).
Business started
businessStarted
Optional
Business start date, YYYY-MM-DD (Full business profile option; the day BBB records, its page can print the day before; null otherwise).
Incorporated
incorporatedDate
Optional
Incorporation date, YYYY-MM-DD (Full business profile option; the day BBB records, its page can print the day before; null otherwise).
BBB file opened
bbbFileOpened
Optional
Date BBB opened its file on the business, YYYY-MM-DD (Full business profile option; the day BBB records, its page can print the day before; null otherwise).
Accredited since
accreditedSince
Optional
BBB accreditation date, YYYY-MM-DD (Full business profile option; the day BBB records, its page can print the day before; null for a business no longer accredited, whose page shows no date, and otherwise).
Started locally
businessStartedLocally
Optional
Date the business started in this local area, YYYY-MM-DD (Full business profile option; the day BBB records, its page can print the day before; null otherwise).
Profile claimed
isClaimed
Optional
True when the owner has claimed the BBB profile (Full business profile option; null otherwise).
Accreditation revoked on
accreditationRevokedAt
Optional
Date BBB revoked the accreditation, YYYY-MM-DD (Full business profile option; the day BBB records, its page can print the day before; null otherwise).
Accreditation statement
accreditationText
Optional
BBB accreditation statement shown on the profile (Full business profile option; null otherwise).
Headquarters
isHeadquarters
Optional
True when this profile is the headquarters of a multi-location business (Full business profile option; null otherwise).
Rating reasons
ratingReasons
Required
Reasons BBB gives for the rating (Full business profile option; [] otherwise).
[ "Length of time business has been operating"]BBB alerts
alerts
Required
Alerts BBB displays on the profile (pattern of complaints, government action…) (Full business profile option; [] otherwise).
[]Review count
reviewCount
Optional
Customer reviews on BBB (profile, or review list when Customer reviews is on).
Average review stars
averageReviewRating
Optional
Average customer review stars, 1-5 (Full business profile option; null otherwise).
Complaint count
complaintCount
Optional
Complaints BBB counts for the business, as its page prints them ("total complaints"): the shown ones and the hidden ones (hiddenComplaints) — from the profile, or the complaint list when Customer complaints is on.
Complaints closed (12 months)
complaintsClosedLast12Months
Optional
Complaints closed in the last 12 months (Full business profile option; null otherwise).
Complaints closed (3 years)
complaintsClosedLast3Years
Optional
Complaints BBB counts over the last 3 years (the profile page's "total complaints in the last 3 years") (Full business profile option; null otherwise).
Multi-location
isMultiLocation
Optional
True when the business has several locations (Full business profile option; null otherwise).
Branches
branches
Required
Other locations of a multi-location business, up to 100 (the first BBB lists): {name, phone, address, city, state, postalCode, url, bbbRating, isAccredited, isHeadquarters}; address is the street line, url the BBB page of that location (Full business profile option; [] otherwise).
[ { "name": "Roto-Rooter Sewer and Drain Cleaning Service", "phone": "(513) 893-0027", "address": "PO Box 2222", "city": "S Burlington", "state": "VT", "postalCode": "05407", "url": "https://www.bbb.org/us/vt/s-burlington/profile/plumber/roto-rooter-sewer-and-drain-cleaning-service-0021-77929/addressId/189402", "bbbRating": "A+", "isAccredited": true, "isHeadquarters": false }]Reviews
reviews
Required
Customer reviews, newest first (Customer reviews option; empty otherwise): {id, rating, reviewerName, date, text, businessResponse, businessResponseDate, thread: [{from, title, date, text}]}; from = business, customer or bbb.
[ { "id": "0825_1000223803_162637", "rating": 5, "reviewerName": "Christina N", "date": "2026-09-09", "text": "Quick and fair.", "businessResponse": "Thank you!", "businessResponseDate": "2026-09-10", "thread": [ { "from": "business", "title": "Calixto Plumbing Response", "date": "2026-09-10", "text": "Thank you!" } ] }]Complaints
complaints
Required
Customer complaints, newest first (Customer complaints option; empty otherwise): {id, type, status, date, text, thread: [{from, date, text}]}.
[ { "id": "0292_1922_25260302", "type": "Service or Repair Issues", "status": "Resolved", "date": "2026-09-10", "text": "I am writing to follow up…", "thread": [ { "from": "business", "date": "2026-09-11", "text": "We appreciate the opportunity…" } ] }]Complaints by type
complaintsByType
Optional
Number of complaints per type, as counted by BBB (Customer complaints option).
Complaints by status
complaintsByStatus
Optional
Number of complaints per status (Customer complaints option).
Source
source
Required
How the business was found: search, directory or url.
Search keyword
searchQuery
Optional
Keyword of the search that found the business (first one when several did).
Search location
searchLocation
Optional
Location of the search that found the business.
Search / start URL
searchUrl
Optional
The search that found the business (its first results page, typed or pasted; in Full directory mode or from a category page, BBB's business index with the place and keyword asked). Null for a business pasted by its URL.
Scraped at
scrapedAt
Required
ISO 8601 timestamp of the extraction.
Social media
socialMedia
Optional
Social media links by network (facebook, instagram, linkedin, x, youtube…) (Full business profile option; null otherwise).