BBB Business Scraper

This Apify actor scrapes business listings and (optionally) detailed business profiles from the Better Business Bureau (BBB) website for any business type and location in the USA or Canada.

Features

• Concurrent scraping: Scrapes up to 5 business profiles at a time for fast results.
• Flexible search: Search by business type, location, and country.
• Detailed output: Extracts business name, phone, website, accreditation status, BBB rating, years in business, owner info, license numbers, categories, and more.
• Clean address: The address field is always formatted as Address, City, State, Zip Code (if available). There are no separate city, state, or zip_code fields in the output.
• Robust extraction: Uses both structured data (JSON-LD) and visible page content for maximum coverage.

Input Schema

• business_type (string): Type of business to search for (e.g. "Garage Door Repair").
• location (string): City and state (e.g. "Jacksonville, FL").
• country (string): Country ("USA" or "Canada").
• max_pages (integer): Maximum number of search result pages to crawl.
• scrape_profiles (boolean): Whether to scrape detailed business profiles.
• include_non_accredited (boolean): Include non-accredited businesses in results.

Output Fields

• business_name
• profile_url
• phone
• address (always formatted as Address, City, State, Zip Code)
• website
• accreditation_status
• bbb_rating
• business_started
• business_incorporated
• bbb_file_opened
• entity_type
• owners
• license_numbers
• categories

Usage

1. Set your search criteria in the Apify input UI or via API.
2. Run the actor.
3. Download the results from the Apify dataset tab.

Local Development

1. Install dependencies:

   pip install -r requirements.txt
   playwright install
   

2. Run the actor locally:

   python src/main.py
   

Notes

• The actor is optimized for Apify's cloud environment but can also be run locally with Docker.
• If you increase the number of concurrent profiles above 5, you may encounter browser crashes or rate limits.
• The address parser is robust for most US/CA addresses, but edge cases may still occur. If you find a problematic address, please report it.

---

MIT License