BBB Scraper — Ratings, Accreditation & Contacts
Pricing
from $4.00 / 1,000 business founds
BBB Scraper — Ratings, Accreditation & Contacts
Scrape Better Business Bureau (bbb.org) businesses by keyword + location or profile URL. Returns BBB rating, accreditation, phone, website, address & contacts. MCP/API-ready.
Pricing
from $4.00 / 1,000 business founds
Rating
0.0
(0)
Developer
Khadin Akbar
Maintained by CommunityActor stats
0
Bookmarked
12
Total users
3
Monthly active users
2 days ago
Last modified
Categories
Features
Share
What is BBB Scraper — Ratings, Accreditation & Contacts?
BBB Scraper extracts Better Business Bureau (bbb.org) business profiles into a dataset, one row per business, from keyword and city searches or from profile URLs. Each row returns the BBB letter rating, accreditation status and dates, years in business, entity type, categories, phone, website, social links, full address with coordinates, opening hours, complaint counts, licences and listed contacts with their roles. Turn on customer reviews to get review rows too. Lead-generation teams, vendor due-diligence analysts, reputation researchers and AI agents use it to build trusted lists of US and Canadian local businesses.
Why teams use this BBB scraper
- Trust signals in one row.
bbbRating,isAccredited,dateAccreditedandyearsInBusinessshow standing at a glance. - Complaint history.
complaintsCount,complaintsClosedLast3YearsandcomplaintsClosedLast12Monthssupport due-diligence checks. - Outreach-ready contacts.
phone,website,socialLinks,formattedAddressandcontacts(name, title and role flags) come with each full profile. - Licences and accreditation dates.
licenseslists number, agency and expiry;accreditationRevokedDateandnewOwnerDateflag changes. - Batch by keyword and city. List several keywords and several cities in one run (up to 100 searches) and get one de-duplicated dataset.
- Optional customer reviews. Reviewer, stars, date, review text and the business reply, one row per review.
- Filters for clean lists.
minRatingandaccreditedOnlykeep only the businesses you want. - Fast on big lists. Pages are fetched in parallel, and memory scales with the size of your run.
Best fit and related Actors
Best fit for US and Canadian service businesses where BBB standing matters: contractors, plumbers, HVAC, roofers, movers and other local trades, plus supplier checks before signing a contract.
- For broader local coverage with reviews and photos, use Google Maps Leads Scraper alongside this Actor.
- To find email addresses behind the
websitecolumn, pass the websites to Bulk Website Contact Extractor.
Example workflow: from trades and cities to a vetted lead list
A home-services marketplace sets searchKeywords to ["plumber", "electrician"], locations to ["Los Angeles, CA", "Austin, TX"], accreditedOnly to true and minRating to A. The run searches all four keyword and city pairs and returns one de-duplicated list with each business's businessName, bbbRating, yearsInBusiness, phone, website, licenses and complaintsCount. They sort by yearsInBusiness, drop businesses with open complaints, and export the shortlist to their partner-onboarding sheet. A monthly schedule per metro area keeps the list current.
How to scrape BBB
- Enter a Search keyword such as
hvac contractorand a Location asCity, ST, or paste profile links in BBB profile URLs. For batches, fill More keywords and More locations. - Set Max businesses, and optionally Minimum BBB rating, BBB-accredited businesses only or Include customer reviews.
- Click Start, then export the dataset as JSON, CSV or Excel, or read it through the API.
Input
{"searchKeyword": "plumber","location": "Los Angeles, CA","country": "US","maxResults": 20,"enrichDetails": true,"includeReviews": false,"minRating": "Any","accreditedOnly": false}
| Field | Type | What it controls |
|---|---|---|
searchKeyword | string | Business type or name, for example plumber or general contractor. |
searchKeywords | array | Extra keywords searched in every location. Up to 100 keyword and city searches per run. |
location | string | City, ST for the US or City, Province for Canada. Optional. |
locations | array | Extra cities, each combined with every keyword. |
country | string | US or CA. Default US. |
startUrls | array | Direct bbb.org/.../profile/... URLs to scrape in depth. |
maxResults | integer | Businesses to return across the run. Default 100, maximum 5000. Reviews do not count toward it. |
enrichDetails | boolean | Open each profile for full detail. Default true. |
includeReviews | boolean | Also return customer reviews as separate rows. Default false. |
maxReviewsPerBusiness | integer | Reviews per business when reviews are on. Default 10, maximum 100. |
minRating | string | Minimum BBB letter rating, from A+ to F, or Any. |
accreditedOnly | boolean | Keep only BBB-accredited businesses. Default false. |
storeRawSample | boolean | Save a raw page sample to the key-value store for inspection. Default false. |
proxyConfiguration | object | Backup route settings. Apify Residential proxy pinned to the chosen country by default. |
Output
One dataset row per business. With reviews on, review rows follow in the same dataset, marked recordType: "review". The dataset has an overview view for businesses and a reviews view for reviews.
| Field | What it contains |
|---|---|
recordType | business or review |
businessName, altBusinessNames | Business name and other registered names |
bbbId, url | BBB business ID and profile URL |
bbbRating | Letter rating from A+ to F |
isAccredited, accreditationStatus, dateAccredited, accreditationRevokedDate | Accreditation flag, label and dates |
businessStarted, incorporatedDate, bbbFileOpened, yearsInBusiness, newOwnerDate, isOutOfBusiness | Business history |
entityType, description, paymentMethods | Entity type, profile description and accepted payments |
categories, primaryCategory | BBB business categories |
phone, additionalPhones, textNumber, email, additionalEmails | Contact details |
website, additionalWebsites, socialLinks | Web presence and social profiles |
street, city, state, postalCode, country, formattedAddress | Address |
latitude, longitude, servingArea | Coordinates and area served |
complaintsCount, complaintsClosedLast3Years, complaintsClosedLast12Months | Complaint history |
ratingCount, averageStarRating | Customer review signals when published |
contacts | Listed contacts with name, title and isPrimary, isPrincipal, isManagement flags |
licenses | Licence number, agency, state, expiry date and notes |
hours | Opening hours by weekday |
reviewerName, reviewStars, reviewDate, reviewText, businessResponseText, businessResponseDate | Review rows only |
scrapedFrom, scrapedAt | Source and collection time |
Fields that a BBB profile does not publish come back empty.
{"recordType": "business","businessName": "Example Plumbing Co","bbbId": "1216-100000001","url": "https://www.bbb.org/us/ca/los-angeles/profile/plumber/example-plumbing-co-1216-100000001","bbbRating": "A+","isAccredited": true,"accreditationStatus": "BBB Accredited Business","dateAccredited": "2010-10-04","yearsInBusiness": 30,"entityType": "Corporation","categories": ["Plumber", "Drain Cleaning"],"phone": "(310) 555-0100","website": "https://www.example.com/","socialLinks": [{ "platform": "facebook", "url": "https://www.facebook.com/example" }],"city": "Los Angeles","state": "CA","complaintsCount": 1,"contacts": [{ "name": "Jordan Example", "title": "President", "isPrimary": true, "isPrincipal": true, "isManagement": true }],"licenses": [{ "licenseNumber": "000000", "agency": "State Contractors Board", "expirationDate": "2027-01-31" }],"scrapedFrom": "profile","scrapedAt": "2026-11-18T10:00:00.000Z"}
A review row looks like this:
{"recordType": "review","businessName": "Example Plumbing Co","reviewerName": "Alex Example","reviewStars": 5,"reviewDate": "2026-10-02","reviewText": "Fast, fair and tidy work.","businessResponseText": "Thank you for the kind words.","scrapedAt": "2026-11-18T10:00:00.000Z"}
Names, numbers and addresses in these examples are fictional placeholders.
Pricing
This Actor uses Pay per event with Apify platform usage included in the event price. Each business is charged once: a Profile enriched event when its full profile is scraped (the default, and every profile URL), or a Business found event when enrichDetails is false and only listing fields are returned. Each customer review returned adds one Review scraped event. Each run also has one Actor Start event. Higher Apify plans get lower event prices.
Worked example in words: an enriched search capped at twenty businesses costs twenty Profile enriched events plus one Actor Start event. The same search with enrichment off costs twenty Business found events instead. With reviews on and ten reviews per business, add up to two hundred Review scraped events. Check the live Pricing tab on this page for current event prices.
API example
curl -X POST "https://api.apify.com/v2/acts/khadinakbar~bbb-scraper/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \-H "Content-Type: application/json" \-d '{"searchKeywords": ["hvac contractor", "plumber"], "locations": ["Austin, TX", "Denver, CO"], "maxResults": 25, "accreditedOnly": true}'
from apify_client import ApifyClientclient = ApifyClient("YOUR_API_TOKEN")run = client.actor("khadinakbar/bbb-scraper").call(run_input={"searchKeyword": "roofing contractor","location": "Toronto, ON","country": "CA","maxResults": 30,"minRating": "A","includeReviews": True,"maxReviewsPerBusiness": 5,})for row in client.dataset(run["defaultDatasetId"]).iterate_items():if row["recordType"] == "business":print(row["businessName"], row["bbbRating"], row["phone"], row["yearsInBusiness"])
Use with AI agents (MCP)
Connect the Actor to Claude, ChatGPT, Cursor or any MCP client through Apify MCP and ask:
Find 20 BBB-accredited plumbers in Los Angeles with an A rating or better. Return name, rating, years in business, phone, website and complaint count.
The agent sets searchKeyword, location, accreditedOnly and minRating, reads rows back from the dataset, and cites each business by url and scrapedAt. maxResults sets the cost scope before the run starts. Rows carry recordType, so an agent can tell business rows from review rows.
Best results
| Starting situation | Helpful action | Expected outcome |
|---|---|---|
| A large metro target | List several suburbs in locations | Wider coverage than a single search, de-duplicated for you |
| Several trades | List them in searchKeywords | One dataset for all trades and cities |
| Listing fields are enough | Set enrichDetails to false | Faster, lighter, cheaper rows |
| A vetted partner list | Combine accreditedOnly with minRating set to A | Only well-rated accredited businesses |
| Known businesses to check | Paste their profile URLs in startUrls | Full detail for exactly those businesses |
| Reputation research | Turn on includeReviews and set maxReviewsPerBusiness | Review text and business replies next to each profile |
| Canadian markets | Set country to CA and location to City, Province | Results from the Canadian BBB directory |
Builder's note
I built this Actor around BBB's trust signals because they are what Google Maps data leaves out: accreditation, letter ratings, complaint history, licences and business age. I made full profiles the default since contacts, hours and history live on the profile page, and kept a lighter listing mode with its own event for runs that only need names and ratings. Large lists were slow in the first version, so version 0.2 fetches pages in parallel and sizes memory to the run. If both the main and the backup fetch route fail for every page, the run ends as failed instead of reporting an empty success.
FAQ
Which countries does it cover?
The United States and Canada, chosen with country.
How do I collect more than one search returns?
One bbb.org search returns at most 225 businesses. List more cities in locations or more keywords in searchKeywords; the Actor merges and de-duplicates the results for you.
Why are some fields empty?
BBB publishes different details for different businesses. Fields such as email, licenses and averageStarRating are filled when the profile shows them.
What happens if bbb.org cannot be reached?
The Actor tries its main route first and a backup route second. If neither can fetch any page, the run finishes as failed. If only some pages fail, it finishes as partial and tells you how many.
Which proxy should I use?
Keep the default Apify Residential proxy pinned to the chosen country. It is used only by the backup route.
Responsible use
This Actor collects publicly available business-directory information from bbb.org. Use it in line with BBB's terms of service and applicable laws. Profiles and reviews can include names of owners, managers and reviewers, which are personal data under laws such as the CCPA and Canada's PIPEDA, so use them only with a lawful basis and honor opt-outs before outreach. BBB is a trademark of its owner; this independent Actor is not affiliated with or endorsed by the Better Business Bureau.