BBB scraper (Python) - Better Business Bureau leads, ratings and accreditation API for the US and Canada
Scrape bbb.org business listings with Python, using the BBB Scraper on Apify. Pass a trade or category ("plumber", "roofing contractors") and a city, ZIP or Canadian postal code; get back one clean JSON row per business: name, categories, BBB letter grade, accreditation, phone, full address, coordinates, service areas, local BBB and profile URL.
Disclosure: I built this actor; it's a paid tool on Apify ($1.00 per 1,000 businesses).
It reads BBB's own search data over plain HTTP (no browser, no login, no API key). BBB shows at most 225 businesses for any one search; the actor's deep search splits big searches by rating grade, state, category, distance and nearby towns and merges them without duplicates. In testing, plumber near Denver (1,954 listed by BBB) returned 1,524 unique business locations in 4 minutes.
- Local-business lead lists. Every plumber, roofer or HVAC company in a metro with phone, street address and ZIP, ready for a CRM or a dialer.
- Trust filtering. Keep only BBB Accredited businesses, or only A-grade ones, before you call or partner.
- Market sizing. Count businesses per trade, city or state;
categoriesandserviceAreasshow who serves where. - Enrichment. Add the BBB grade and accreditation to a list of companies you already have by pasting BBB profile or search URLs.
pip install apify-clientfrom apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("rel8ble/bbb-business-scraper").call(run_input={
"searchQueries": ["plumber"],
"locations": ["Denver, CO"],
"accreditedOnly": True,
"maxItems": 100,
})
for biz in client.dataset(run["defaultDatasetId"]).iterate_items():
print(biz["name"], "|", biz["rating"], "|", biz["phone"], "|", biz["city"], biz["state"])Get your token at https://console.apify.com/settings/integrations.
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('rel8ble/bbb-business-scraper').call({
searchQueries: ['roofing contractors'],
locations: ['Houston, TX', '77002'],
ratings: ['A'],
maxItems: 0, // 0 = everything the search can reach (deep search goes past 225)
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.map((b) => `${b.name} (${b.rating}) ${b.phone}`));example.py runs your trades across your cities, writes bbb_leads.csv, and prints how many businesses each search found, the accredited share and the grade mix.
pip install -r requirements.txt
set APIFY_TOKEN=<YOUR_APIFY_TOKEN> # export APIFY_TOKEN=... on macOS/Linux
python example.py "Denver, CO" "Austin, TX" -- plumber electrician| Field | Default | Description |
|---|---|---|
searchQueries |
- | Trades or categories as typed into the BBB search box, one search each |
locations |
- | "City, ST", a US ZIP (80212) or a Canadian postal code (M5V 2T6) |
accreditedOnly |
false |
Only BBB Accredited businesses |
ratings |
all | Any of A, B, C, D, F (A includes A+ and A-) |
maxDistanceMiles |
none | 5, 10, 25, 50 or 100 miles from each location |
states |
all | Two-letter state or province codes to keep |
categories |
all | Exact BBB category names, e.g. Water Heater Repair |
skipOutOfBusiness |
true |
Leave out (and don't charge for) closed businesses |
sort |
relevance |
relevance, distance, rating, atoz, ztoa |
maxItems |
100 |
Per search; 0 = everything |
deepSearch |
true |
Go past BBB's 225-per-search limit |
startUrls |
- | BBB search or profile URLs copied from bbb.org |
From a cloud run on 17 Oct 2026, plumber in Denver, CO:
{
"name": "Ennis Plumbing LLC",
"category": "Plumber",
"categories": ["Plumber", "Commercial Plumber"],
"rating": "A+",
"accredited": true,
"phone": "(720) 660-9812",
"address": "4865 Golden Ct",
"city": "Denver",
"state": "CO",
"postalCode": "80212",
"country": "US",
"latitude": 39.74,
"longitude": -104.97,
"profileUrl": "https://www.bbb.org/us/co/denver/profile/plumber/ennis-plumbing-llc-1296-90156205",
"serviceAreas": ["Thornton, CO"],
"outOfBusiness": false,
"localBbb": "BBB Great West + Pacific",
"sourceQuery": "plumber",
"sourceLocation": "Denver, CO",
"position": 1
}$1.00 per 1,000 businesses, pay per result. No start fee; failed requests, duplicates and out-of-business listings are not charged. A 100-business search costs about $0.10.
- BBB caps one search at 225 businesses. Deep search reaches most but not all of BBB's own count (78% for plumbers near Denver, 72% for roofers near Houston); BBB's count also includes loose keyword matches, so the true number of real matches is lower.
- Emails and websites are not on BBB search results; pair it with a contact scraper if you need them.
- US and Canada only (that's where BBB operates).
- Actor on the Apify Store: https://apify.com/rel8ble/bbb-business-scraper
- Apify Python client docs: https://docs.apify.com/api/client/python/
MIT for the example code in this repo. The actor itself is a paid service on Apify.