Skip to content

About

BBB (Better Business Bureau) scraper in Python: business leads, ratings, accreditation, phones and addresses for the US and Canada via Apify

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

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.

Why use it

  • 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; categories and serviceAreas show 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.

Quick start (Python)

pip install apify-client
from 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.

Quick start (Node.js)

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}`));

Full example: lead list to CSV

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

What the input accepts

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

Output (real row, trimmed)

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
}

Pricing

$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.

Limits

  • 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).

Links

License

MIT for the example code in this repo. The actor itself is a paid service on Apify.

About

BBB (Better Business Bureau) scraper in Python: business leads, ratings, accreditation, phones and addresses for the US and Canada via Apify

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages