BBB Business Details Scraper

🚀 BBB Business Details Scraper

Turn any Better Business Bureau profile URL into a complete business record. The BBB Business Details Scraper returns what the search results do not: principals and management with names and titles, email and every phone number, websites and social links, the BBB rating with its reasons, accreditation dates, licenses with the issuing agency, years in business, entity type, and complaint and review totals — plus, on request, the full complaint history and customer reviews. Built for B2B lead qualification, KYB and vendor vetting, reputation monitoring and risk scoring.

Pairs with the BBB Advanced Scraper: search by keyword and location there, then feed the profile URLs here.

✨ Features

• 🧑‍💼 Decision makers: Principals and management contacts with full names and titles, straight from the profile.
• 📞 Every contact channel: Primary phone, additional phones, fax, de-obfuscated email, websites and social profiles.
• ⭐ Trust signals: BBB rating and the reasons behind it, accreditation status and date, alerts, claimed status, out-of-business flag.
• 📜 Licenses and history: License numbers with the issuing agency, file-opened, business-start and incorporation dates, years in business, entity type.
• ⚠️ Complaint history (optional): Every complaint with type, status, date, full text and the business's responses, paginated to the cap you set.
• 💬 Customer reviews (optional): Star rating, reviewer, date, text and the business's reply.
• 🇺🇸🇨🇦 US and Canada: Any bbb.org profile URL works, including /details, /complaints and /customer-reviews variants.
• 💸 Pay per record: One price per business profile, a small price per complaint or review — nothing charged for profiles that no longer exist.

🛠️ How It Works

1. Paste profile URLs – Add BBB business profile URLs (or the url column from the BBB Advanced Scraper's results).
2. Choose the depth – Turn on Include complaints and/or Include customer reviews if you need them, and set per-business caps.
3. Run the scraper – Get one JSON record per business, ready for your CRM, spreadsheet or enrichment pipeline.

💰 Pricing

Event	Price	What you get
Business profile	$0.015	The full record shown below (everything except complaints and reviews)
Complaint	$0.005	One complaint with responses, only when Include complaints is on
Customer review	$0.005	One review with the business's reply, only when Include customer reviews is on

A run over 100 profiles with no complaints or reviews costs $1.50. Profiles that return "not found" are free.

📥 Input

Field	Type	Description
startUrls	array	BBB business profile URLs. Sub-pages and addressId variants are normalised to the profile.
includeComplaints	boolean	Collect the complaint history. Default false.
includeReviews	boolean	Collect customer reviews. Default false.
maxItems	integer	Maximum businesses per run. Default 50.
maxComplaintsPerBusiness	integer	Cap per business when complaints are on. Default 100.
maxReviewsPerBusiness	integer	Cap per business when reviews are on. Default 100.
proxyConfiguration	object	Keep the default (US residential).

📊 Sample Output Data

One record per business. Example (complaints and reviews trimmed to one item each):

{
    "bbbId": "0875",
    "businessId": "9237",
    "url": "https://www.bbb.org/us/tx/plano/profile/security-system-monitors/smith-thompson-home-security-0875-9237",
    "name": "Smith Thompson Home Security",
    "alternateNames": [
        "Thompson Home Services, LLC",
        "Smith Thompson Home Security and Alarm Houston",
        "Smith Thompson Home Security and Alarm Austin",
        "Smith Thompson Home Security and Alarm San Antonio"
    ],
    "category": "Security System Monitors",
    "categories": [
        "Security System Monitors",
        "Heating and Air Conditioning",
        "Pest Control Services",
        "Air Conditioning Contractors",
        "Security Systems",
        "Security Systems Consultants",
        "Home Automation",
        "Smart Home Security"
    ],
    "description": null,
    "address": {
        "line1": "6652 Pinecrest Dr STE 500",
        "line2": null,
        "city": "Plano",
        "state": "TX",
        "zip": "75024-2943",
        "country": "US",
        "formatted": "6652 Pinecrest Dr STE 500, Plano, TX 75024-2943"
    },
    "latitude": 33.06602,
    "longitude": -96.80907,
    "isHeadquarters": false,
    "locationsCount": 4,
    "phone": "(972) 526-8500",
    "additionalPhones": ["(972) 661-8585", "(800) 728-6906", "(972) 393-2000"],
    "fax": ["(972) 526-8510"],
    "email": null,
    "additionalEmails": [],
    "website": "https://smiththompson.com/",
    "websites": [],
    "socialLinks": [
        {
            "type": "facebook",
            "url": "https://www.facebook.com/smiththompsonmonitoring/timeline/"
        },
        {
            "type": "instagram",
            "url": "https://www.instagram.com/smiththompsonsecurity/"
        }
    ],
    "contacts": [
        {
            "name": "Mr. Mark S. Thompson",
            "title": "President",
            "isPrincipal": true,
            "isManagement": true
        },
        {
            "name": "Ms. Lynda Thompson",
            "title": "Vice President",
            "isPrincipal": true,
            "isManagement": true
        }
    ],
    "rating": "A+",
    "ratingReasons": [],
    "isAccredited": true,
    "accreditedSince": "1987-01-01",
    "accreditationRevoked": null,
    "bbbFileOpened": "1985-10-01",
    "businessStarted": "1977-01-01",
    "incorporated": "2012-03-16",
    "yearsInBusiness": 49,
    "numEmployees": null,
    "entityType": "Limited Liability Company (LLC)",
    "paymentMethods": [],
    "licenses": [],
    "complaintsTotal": 11,
    "complaintsClosedLast3Years": 11,
    "complaintsClosedLast12Months": 3,
    "reviewsTotal": 10,
    "averageReviewRating": 3,
    "alerts": [],
    "additionalInformation": [
        {
            "title": "Referral Assistance",
            "text": "Texas Department of Agriculture\n2405 Texas Avenue South\nCollege Station TX 77840\nPhone Number: (979) 680-5213\nbrenda.carlson@tx.usda.gov"
        }
    ],
    "isOutOfBusiness": false,
    "isClaimed": true,
    "localBbb": "BBB serving North Central Texas",
    "status": "ok",
    "scrapedAt": "2026-09-13T17:17:30.734Z",
    "complaints": [
        {
            "id": "0875_9237_24907723",
            "date": "2026-06-03",
            "type": "Product Issues",
            "status": "Answered",
            "text": "I am filing this complaint because Smith Thompson Home Security has repeatedly failed to provide documentation related to a false alarm inci …",
            "responses": [
                {
                    "date": "2026-06-05",
                    "by": "business",
                    "text": "We were able to forward all the dates and times of this event to the customer, and certainly apologi …"
                }
            ]
        }
    ],
    "reviews": [
        {
            "id": "0875_9237_4657977",
            "date": "2026-01-30",
            "rating": 1,
            "reviewer": "Michael G",
            "text": "I would not recommend them. I always paid for the yearly service up front.  At first things were fine.  Then at one point my phone wasnt alw …",
            "businessResponse": null,
            "businessResponseDate": null,
            "customerRebuttal": null
        }
    ]
}

Profiles that no longer exist come back as { "url": "...", "status": "not_found" } and are not charged.

🔗 Use cases

• Lead qualification: Enrich a prospect list with principals, direct phones, email, rating and complaint counts before outreach.
• KYB / vendor vetting: Accreditation date, licenses, years in business, entity type and alerts in one call per company.
• Reputation monitoring: Re-run on your own or your competitors' profiles and diff complaints and reviews over time.
• Risk scoring: Complaints closed in the last 12 months and 3 years, average review stars and rating reasons as model features.

Know who you are dealing with — run the BBB Business Details Scraper today! 🚀