BBB Scraper — Ratings, Accreditation & Contacts avatar

BBB Scraper — Ratings, Accreditation & Contacts

Pricing

from $4.00 / 1,000 business founds

Go to Apify Store
BBB Scraper — Ratings, Accreditation & Contacts

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

Khadin Akbar

Maintained by Community

Actor stats

0

Bookmarked

12

Total users

3

Monthly active users

2 days ago

Last modified

Features

Limited permissions

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, dateAccredited and yearsInBusiness show standing at a glance.
  • Complaint history. complaintsCount, complaintsClosedLast3Years and complaintsClosedLast12Months support due-diligence checks.
  • Outreach-ready contacts. phone, website, socialLinks, formattedAddress and contacts (name, title and role flags) come with each full profile.
  • Licences and accreditation dates. licenses lists number, agency and expiry; accreditationRevokedDate and newOwnerDate flag 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. minRating and accreditedOnly keep 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 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.

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

  1. Enter a Search keyword such as hvac contractor and a Location as City, ST, or paste profile links in BBB profile URLs. For batches, fill More keywords and More locations.
  2. Set Max businesses, and optionally Minimum BBB rating, BBB-accredited businesses only or Include customer reviews.
  3. 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
}
FieldTypeWhat it controls
searchKeywordstringBusiness type or name, for example plumber or general contractor.
searchKeywordsarrayExtra keywords searched in every location. Up to 100 keyword and city searches per run.
locationstringCity, ST for the US or City, Province for Canada. Optional.
locationsarrayExtra cities, each combined with every keyword.
countrystringUS or CA. Default US.
startUrlsarrayDirect bbb.org/.../profile/... URLs to scrape in depth.
maxResultsintegerBusinesses to return across the run. Default 100, maximum 5000. Reviews do not count toward it.
enrichDetailsbooleanOpen each profile for full detail. Default true.
includeReviewsbooleanAlso return customer reviews as separate rows. Default false.
maxReviewsPerBusinessintegerReviews per business when reviews are on. Default 10, maximum 100.
minRatingstringMinimum BBB letter rating, from A+ to F, or Any.
accreditedOnlybooleanKeep only BBB-accredited businesses. Default false.
storeRawSamplebooleanSave a raw page sample to the key-value store for inspection. Default false.
proxyConfigurationobjectBackup 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.

FieldWhat it contains
recordTypebusiness or review
businessName, altBusinessNamesBusiness name and other registered names
bbbId, urlBBB business ID and profile URL
bbbRatingLetter rating from A+ to F
isAccredited, accreditationStatus, dateAccredited, accreditationRevokedDateAccreditation flag, label and dates
businessStarted, incorporatedDate, bbbFileOpened, yearsInBusiness, newOwnerDate, isOutOfBusinessBusiness history
entityType, description, paymentMethodsEntity type, profile description and accepted payments
categories, primaryCategoryBBB business categories
phone, additionalPhones, textNumber, email, additionalEmailsContact details
website, additionalWebsites, socialLinksWeb presence and social profiles
street, city, state, postalCode, country, formattedAddressAddress
latitude, longitude, servingAreaCoordinates and area served
complaintsCount, complaintsClosedLast3Years, complaintsClosedLast12MonthsComplaint history
ratingCount, averageStarRatingCustomer review signals when published
contactsListed contacts with name, title and isPrimary, isPrincipal, isManagement flags
licensesLicence number, agency, state, expiry date and notes
hoursOpening hours by weekday
reviewerName, reviewStars, reviewDate, reviewText, businessResponseText, businessResponseDateReview rows only
scrapedFrom, scrapedAtSource 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 ApifyClient
client = 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 situationHelpful actionExpected outcome
A large metro targetList several suburbs in locationsWider coverage than a single search, de-duplicated for you
Several tradesList them in searchKeywordsOne dataset for all trades and cities
Listing fields are enoughSet enrichDetails to falseFaster, lighter, cheaper rows
A vetted partner listCombine accreditedOnly with minRating set to AOnly well-rated accredited businesses
Known businesses to checkPaste their profile URLs in startUrlsFull detail for exactly those businesses
Reputation researchTurn on includeReviews and set maxReviewsPerBusinessReview text and business replies next to each profile
Canadian marketsSet country to CA and location to City, ProvinceResults 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.