BBB Business Scraper - Better Business Bureau Profiles & Reviews

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Web Scraping

This actor extracts data from websites. It handles JavaScript rendering, pagination, and anti-bot measures automatically.

Note: Always respect the website's terms of service and robots.txt.

---

Scrape Better Business Bureau profiles, ratings, complaints, reviews, and accreditation data. Get comprehensive business reputation data including BBB ratings, complaint history, customer reviews, and accreditation status. Features: - Business profile data extraction - BBB rating and accreditation status - Complaint history and resolution - Customer reviews and responses - Business category and contact info - Years in business and licensing Ideal for: - Reputation monitoring - Competitor research - Due diligence - Lead qualification. Built by John Rippy (https://www.linkedin.com/in/johnrippy/ | https://johnrippy.link/).

Features

• Profile Scraping: Get complete BBB profile data for any business
• Search: Find businesses by name, location, and category
• Complaint Data: Extract complaint counts, types, and resolution status
• Review Extraction: Scrape customer reviews with ratings
• Accreditation Check: Verify BBB accreditation status
• Bulk Processing: Scrape multiple businesses in one run

Quick Start

{
  "url": "https://example.com",
  "maxResults": 100
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

Input Parameters

Parameter	Type	Description
scrapeType	string	Type: business_profile, search, complaints, reviews
businessUrl	string	Direct BBB business profile URL
businessName	string	Business name to search for
location	string	City and state (e.g., 'Los Angeles, CA')
category	string	Business category filter
accreditedOnly	boolean	Only return accredited businesses
minRating	string	Minimum BBB rating (A+ to F)
includeComplaints	boolean	Scrape complaint details (default: true)
includeReviews	boolean	Scrape customer reviews (default: true)
maxResults	number	Maximum businesses to scrape (default: 50)
proxyConfiguration	object	Proxy settings
demoMode	boolean	Return sample data for testing

Output Format

Business Profile Output

{
  "businessName": "ABC Plumbing Services Inc",
  "bbbUrl": "https://www.bbb.org/us/ca/los-angeles/profile/plumber/abc-plumbing-0123-456789",
  "rating": "A+",
  "accredited": true,
  "accreditedSince": "2015-03-15",
  "yearsInBusiness": 12,
  "businessStarted": "2012-01-01",
  "address": {
    "street": "123 Main Street",
    "city": "Los Angeles",
    "state": "CA",
    "zip": "90001"
  },
  "phone": "(323) 555-1234",
  "website": "https://abcplumbing.com",
  "categories": ["Plumber", "Water Heater Repair", "Drain Cleaning"],
  "complaints": {
    "total": 5,
    "lastThreeYears": 3,
    "closed": 5,
    "resolved": 4,
    "byType": {
      "service": 2,
      "billing": 2,
      "product": 1
    }
  },
  "reviews": {
    "averageRating": 4.2,
    "totalCount": 47,
    "positive": 38,
    "neutral": 5,
    "negative": 4
  },
  "licenses": [
    {
      "type": "Contractor License",
      "number": "C-12345",
      "status": "Active"
    }
  ],
  "scrapedAt": "2024-12-21T10:30:00.000Z"
}

Complaint Detail Output

{
  "complaintId": "12345678",
  "dateOpened": "2024-11-15",
  "dateClosed": "2024-12-01",
  "type": "Service Issues",
  "status": "Resolved",
  "summary": "Customer reported incomplete work",
  "businessResponse": true,
  "resolution": "Company completed work and provided partial refund"
}

Pricing

This actor uses pay-per-event billing: This actor uses pay-per-event pricing:

Event	Description	Price
apify-actor-start	Base cost per run	$0.10
business_scraped	Per business profile scraped	$0.015
complaint_scraped	Per complaint extracted	$0.005
review_scraped	Per review extracted	$0.003

Example costs:

• 50 businesses with complaints: $0.10 + (50 × $0.015) + (250 × $0.005) = $2.10
• 100 businesses, no complaints: $0.10 + (100 × $0.015) = $1.60

Use Cases

• Due Diligence: Verify business legitimacy before partnerships
• Competitor Research: Compare BBB ratings with competitors
• Lead Qualification: Filter leads by BBB rating and accreditation
• Reputation Monitoring: Track your BBB profile and complaints
• Market Research: Analyze industry complaint patterns
• Citation Building: Verify NAP data from authoritative source

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal