BBB Business Scraper

Extract business listings from the Better Business Bureau (BBB.org) directory. Search by business type and location across the US and Canadian directories to collect contact details, BBB ratings, accreditation status, addresses, and more.

What it does

This actor searches BBB.org for businesses matching your query and location, then extracts structured data from the search results. BBB.org has information on millions of businesses, including contact details that are often more complete and verified than other directories.

Example use cases:

• Build prospect lists for a specific industry in a target city
• Verify business legitimacy and BBB rating before engaging a vendor
• Collect contact information for local service providers
• Research which businesses in a category hold BBB Accreditation

Input

Field	Type	Description
searchQuery	String	Business name or category (e.g. "plumber", "auto repair", "John's Diner")
location	String	City, state or ZIP code (e.g. "Chicago, IL" or "90210")
country	String	USA (United States) or CAN (Canada)
maxItems	Integer	Maximum number of businesses to return
enrichWithDetails	Boolean	When true, visits each profile page for principal contacts and email. Slower but more complete. Default: false

Example input:

{
  "searchQuery": "restaurant",
  "location": "New York, NY",
  "country": "USA",
  "maxItems": 50,
  "enrichWithDetails": false
}

Output

Each record in the dataset represents one BBB business listing:

Field	Description
business_id	Unique BBB identifier extracted from the profile URL
name	Business name as listed on BBB
bbb_rating	BBB letter grade (A+, A, B, C, D, F, or NR for Not Rated)
is_accredited	Whether the business holds BBB Accreditation
phone	Primary phone number
street_address	Street address
city	City
state	State or province code
zip	ZIP or postal code
country	Country code (US or CA)
website	Business website URL
email	Email address (when listed; more common with enrichWithDetails: true)
categories	Business categories, comma-separated
years_in_business	Years the business has been in operation
num_employees	Employee count range
principal_name	Primary contact name (populated with enrichWithDetails: true)
principal_title	Primary contact title (populated with enrichWithDetails: true)
logo_url	Business logo image URL
profile_url	Full URL to the BBB business profile
scraped_at	Timestamp when this record was scraped

Example output record:

{
  "business_id": "87156789",
  "name": "Acme Plumbing Co.",
  "bbb_rating": "A+",
  "is_accredited": true,
  "phone": "(212) 555-0123",
  "street_address": "123 Main St",
  "city": "New York",
  "state": "NY",
  "zip": "10001",
  "country": "US",
  "website": "https://acmeplumbing.example.com/",
  "email": "",
  "categories": "Plumbers",
  "years_in_business": "15",
  "num_employees": "11-50",
  "principal_name": "",
  "principal_title": "",
  "logo_url": "https://...",
  "profile_url": "https://www.bbb.org/us/ny/new-york/profile/plumbers/acme-plumbing-co-0121-87156789",
  "scraped_at": "2026-06-02T20:50:00.000Z"
}

Performance and cost

BBB.org uses Cloudflare protection, so this actor uses a real browser with residential proxy to bypass it. This makes it slower and more expensive than simple HTTP scrapers. Expect roughly 10-30 businesses per minute depending on network conditions.

Guidance:

• Default mode (enrichWithDetails: false) — saves records from search result cards. Fast and reliable; covers name, rating, address, phone, and categories.
• Detail enrichment mode (enrichWithDetails: true) — visits each business profile page. Slower due to additional page loads, but adds principal contacts and email when listed.

Notes

• Results are limited to businesses that appear in BBB's search index. Not all businesses are registered with BBB.
• Email addresses are not consistently listed on BBB profiles.
• BBB accreditation is a paid service — "accredited" status means the business has applied and meets BBB standards, not that it is necessarily better or worse.
• Canadian businesses are available by setting country: CAN.