# Us Bbb Business Leads Scraper (`scrapebench/us-bbb-business-leads-scraper`) Actor

Rated US home-service businesses by trade, state, city or ZIP: roofers, plumbers, HVAC, electricians, contractors and more, with phone, address, rating, accreditation, categories and service areas.

- **URL**: https://apify.com/scrapebench/us-bbb-business-leads-scraper.md
- **Developed by:** [ScrapeBench](https://apify.com/scrapebench) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0007 / rated business lead

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## US Home Services Business Leads Scraper (Rated, with Phone)

### Pain points

- A search for roofers or plumbers in a big city stops after 200+ results, so a metro list is always incomplete.
- A rating-only list has no website or e-mail, so the outreach step needs a second tool.
- Businesses list several phone numbers (tracking lines, other cities) and a list that picks one silently sends you to the wrong line.

### What we solve

- Past the 225-result ceiling: each ZIP search is read in three sort orders (600+ listings instead of 225; 600+ distinct of 600+ rows measured on a 6,495-result query) and a trade is searched ZIP by ZIP across a state's counties and de-duplicated.
- Each row has the business's phone, street address, rating, accreditation flag, trade categories and the towns it serves.
- Rows with several phone numbers say so (`multiple_phones`) and list them all in `phones`.
- With 'Add BBB profile details' on, each business's profile adds its website, e-mail, named owner or contacts, years in business, start, incorporation and accreditation dates, entity type, licence numbers, complaint and review counts, other phones and websites, hours and services, as published.

### Summary

Rated home-service businesses across the United States in 14 trades: roofing, plumbing, HVAC, electricians, general contractors, painting, landscaping and fencing, flooring, windows and siding, concrete and masonry, garage doors, pest control, cleaning and movers. A row is one business location: its name, trade categories, phone, street, city, state, ZIP, letter rating and score, whether it is accredited, and the towns it serves. Pick states, trades, cities and ZIP codes, or look a business up by name. With 'Add BBB profile details' on, each row also gets what the business's profile publishes (website, e-mail, owner or contact names with titles, years in business, start, incorporation and accreditation dates, entity type, licence numbers, complaint and review counts, other phones and websites, hours, products and services). With 'Include contact details' on, a row still missing a website is looked up by its name and town; with 'Find e-mail addresses' on, a business with a website and no e-mail gets one when its own site publishes it. Businesses marked out of business are left out. Filter to accredited businesses or a minimum rating score.

### Who it's for

- Roofing, solar and storm-restoration sales teams building territory lists
- Suppliers, software vendors and insurers calling trade businesses
- Lead-gen and local-marketing agencies
- Franchisors and acquirers screening independents by rating

### How to use

This actor does two jobs. Run it, then collect results from the run's dataset (export to JSON/CSV/Excel, or pull via the Apify API).

**Get a list (export):** no names, just filters; returns the whole matching list.

```json
{
  "states": [
    "CA"
  ],
  "categories": [
    "Roofing"
  ],
  "cities": [
    "Los Angeles"
  ],
  "accreditedOnly": true,
  "minRatingScore": 97,
  "includeContacts": false,
  "findEmails": false,
  "maxResults": 100
}
```

**Check specific firms (lookup):** put company names or licence numbers in `mode`, `queries`, `states`, `cities`, `includeProfiles`; **Inputs** below says how each is matched.

```json
{
  "mode": "lookup",
  "queries": [
    "roofing"
  ],
  "states": [
    "CA"
  ],
  "cities": [
    "Los Angeles"
  ],
  "includeProfiles": true,
  "maxResults": 20
}
```

See **Inputs** below for every available field.

### What you get

One row per record:

| Field | Description |
|---|---|
| `name` | Business name as listed |
| `category` | The business's main trade category; categories lists all of them |
| `phone` | Main phone as listed; phone_e164 holds it as +1XXXXXXXXXX |
| `extras.phones` | Every phone number listed, present with extras.multiple_phones when there is more than one |
| `extras.rating` | Letter rating (A+ to F) and extras.rating_score, its 0-100 score |
| `extras.accredited` | Whether the business is accredited |
| `extras.service_areas` | Towns and ZIP codes the business says it serves |
| `website` | Website, from the business's profile or found by its name |
| `email` | E-mail published on the business's profile or on its own website, where found |
| `extras.contacts` | Profile details: owner and contact names with their titles, as the profile lists them |
| `extras.years_in_business` | Profile details: years in business; extras.business_started, extras.incorporated and extras.accredited_since (YYYY-MM-DD), extras.entity_type (LLC, Corporation ...) and extras.licences (number, issuing agency) beside it |
| `extras.complaints_total` | Profile details: complaints on file; extras.complaints_closed_12m / \_3y, extras.reviews_total and extras.review_stars beside it |
| `extras.other_phones` | Profile details: other phones, extras.fax, extras.other_emails, extras.other_websites (review-site pages), extras.hours, extras.products_services, extras.description, extras.payment_methods |
| `street` | Street address; city, region (state code) and postal_code beside it |
| `listing_id` | A stable id for the business location |
| `source_url` | The business's listing page |
| `lat / lng` | Latitude and longitude of the business address, for maps |

Sample:

```json
{
  "name": "Stevan Buren Roofing, Windows, and Flooring",
  "listing_id": "0825_235975973_405674",
  "category": "Roofing Contractors",
  "categories": [
    "Roofing Contractors",
    "Siding Contractors",
    "Windows",
    "Window Installation"
  ],
  "phone": "(817) 558-6997",
  "phone_e164": "+18175586997",
  "street": "108 Wild Basin Rd Suite 250",
  "city": "Austin",
  "region": "TX",
  "postal_code": "78746",
  "country": "US",
  "website": "https://www.stevanburen.com/commercial",
  "extras": {
    "rating": "A+",
    "rating_score": 97,
    "accredited": true,
    "phones": [
      "(817) 558-6997",
      "(210) 686-1425"
    ],
    "multiple_phones": true,
    "service_areas": [
      "Aledo, TX",
      "Fort Worth, TX"
    ],
    "contacts": [
      {
        "name": "Stevan Buren",
        "title": "Owner"
      }
    ],
    "years_in_business": 21,
    "business_started": "2005-06-24",
    "accredited_since": "2013-09-30",
    "entity_type": "Corporation",
    "complaints_total": 1,
    "complaints_closed_12m": 0,
    "reviews_total": 2,
    "review_stars": 5
  },
  "source_url": "https://www.bbb.org/us/tx/austin/profile/roofing-contractors/stevan-buren-roofing-windows-and-flooring-0825-235975973/addressId/405674"
}
```

### Inputs

| Field | Required | Type | Default | Description |
|---|---|---|---|---|
| `mode` | no | string | `"auto"` | export: no names, just filters; returns the whole matching list. lookup: put business names in 'queries'. auto picks the mode for you. |
| `query` | no | string | — | A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks. |
| `queries` | no | array | `[]` | A business name (or listing number) to look up live. Several values in one run; combined with 'query'. |
| `state` | no | string | — | Only listings in this state. Kept alongside 'states' for saved tasks. |
| `states` | no | array | `[]` | Only listings in this state. Several values in one run; combined with 'state'. |
| `city` | no | string | — | Only listings in this city. Kept alongside 'cities' for saved tasks. |
| `cities` | no | array | `[]` | Only listings in this city. Several values in one run; combined with 'city'. |
| `zip` | no | string | — | Only listings in this ZIP code. Kept alongside 'zips' for saved tasks. |
| `zips` | no | array | `[]` | Only listings in this ZIP code. Several values in one run; combined with 'zip'. |
| `categories` | no | array | `[]` | Only rows from this trade (one or more). Available: Cleaning, Concrete and masonry, Electricians, Flooring, Garage doors, General contractors, HVAC, Landscaping and fencing, Movers, Painting, Pest control, Plumbing, Roofing, Windows and siding. |
| `includeContacts` | no | boolean | `true` | Add each business's phone, website and street address where available, looked up by business name. Charged as a separate 'Contact details found' event per row that gets one; a row without a contact costs only the row price. Only fields the source left empty are filled. Turn off for the list alone. |
| `findEmails` | no | boolean | `true` | For a business with a website and no e-mail, look for one on the business's own website. Charged as a separate 'E-mail found' event only when one is found. On a large export this adds time; a run that reaches its time limit delivers the remaining rows without the check and says how many. Turn off for the fastest export. |
| `accreditedOnly` | no | boolean | `false` | Keep only businesses that are accredited. Applied before the maxResults cap, so the cap counts accredited rows. |
| `includeProfiles` | no | boolean | `false` | Opens each delivered business's BBB profile and adds what it publishes: website, e-mail, owner and contact names with titles, years in business, business start / incorporation / accreditation dates, entity type, licence numbers, complaint and review counts, other phones, fax and websites, opening hours, products and services, description and payment methods. Charged as a separate 'BBB profile details' event per business whose profile is read; a profile that does not answer is not charged. Adds about a second per business; a run that reaches its time limit delivers the rest without and says how many. |
| `minRatingScore` | no | integer | `1` | Keep only businesses whose 0-100 rating score is at least this. Measured bands: A+ 97 and up, A 94-96, A- 91-93, B- about 80, C about 70-77, F 54-59; businesses with no rating count as 0. 1 = no filter. Applied before the maxResults cap, so the cap counts rows that pass. |
| `maxResults` | no | integer | `500` | Per query in lookup mode; per run in export mode. |
| `proxyConfiguration` | no | object | `{"useApifyProxy": false}` | Used only for live lookups; exports read the stored snapshot. |

### Pricing (Pay Per Event)

You pay per result (`dataset-item`) — **no charge for empty runs**. Example: **1000 rated business leads** at *$0.0007/result* ≈ **$0.70**.

One event per business returned. With 'Add BBB profile details' on, each business whose profile is read is also charged a 'BBB profile details' event ($0.004). With 'Include contact details' on, a row that gets a missing website or phone by a lookup on its name is also charged a 'Contact details found' event; with 'Find e-mail addresses' on, a row whose e-mail is found on the business's own website is also charged an 'E-mail found' event. All three are off in the example. Notices are free.

### Use cases

- Lead generation: every roofer, plumber or HVAC company of a state, city or ZIP with phone, address and, where found, website and e-mail.
- Vendor and supplier vetting: a rated shortlist of contractors before you engage; set 'Accredited businesses only' and a minimum rating score.
- Risk screening: flag businesses with a low rating (F, D) in a trade and metro before lending, insuring or partnering.
- Territory planning and sales prospecting: accredited A+ businesses in a trade and city, on a map (latitude and longitude on every row).
- Market research: count businesses per trade, city or ZIP, and see how they are rated and how many are accredited.
- Business look-ups: a company's phone, address, rating and accreditation by name.
- Recurring lists: schedule the same export and compare runs by `listing_id`.

### Why this actor

- Deeper than one search: three sort orders per ZIP reach 600+ listings where a single search stops at 225.
- Rating, accreditation, categories and service areas on every row.
- Several phone numbers are listed, not silently reduced to one.
- Owner names, years in business, business dates and complaint counts from each business's profile, on the same row, on request.
- One price per row; profile, contact and e-mail add-ons are charged only for rows that get one.

### Limitations & updates

Covers businesses publicly listed in 14 home-service trades in the 50 states and DC. A trade is the one the business lists itself under, so expect the odd neighbouring trade. A state export is a slow, paced read (one request every few seconds), so a whole state is best served from the stored copy when one exists; a live run covers a city or a few ZIP codes comfortably. Each search shows at most about 675 of its results, so a very large metro is covered in part, not completely. Businesses without a listing are not in it. Profile details (owner, years in business, dates, complaints, reviews) come with 'Add BBB profile details' on and only for businesses whose profile answered within the run's time (about a second each); a run that runs out of time says how many rows went without. Website and e-mail are found only for some rows.

### FAQ

**Where does the data come from?**

From publicly listed business profiles: what businesses and their local Better Business Bureau publish (name, address, phone, rating, accreditation, categories, service areas). Businesses marked out of business are left out. With 'Add BBB profile details' on, each business's profile adds its website, e-mail, owner names, years in business, business dates and complaint and review counts. With 'Include contact details' on, a website still missing is looked up separately, and 'Find e-mail addresses' checks the business's own website.

**Which trades are included?**

Roofing, Plumbing, HVAC, Electricians, General contractors, Painting, Landscaping and fencing, Flooring, Windows and siding, Concrete and masonry, Garage doors, Pest control, Cleaning and Movers.

**Does it include complaints, reviews, years in business or owner names?**

Yes, with 'Add BBB profile details' on (charged per business whose profile is read): extras.complaints_total, extras.complaints_closed_12m and \_3y, extras.reviews_total and extras.review_stars, extras.years_in_business with the start, incorporation and accreditation dates, and extras.contacts with the owner and contact names and titles the profile lists. A field the business's profile leaves empty is left out. Review texts and complaint details are not included.

**Why do some rows have several phone numbers?**

Businesses list more than one line, and some list lines in other cities. The first listed number is the phone; every number is in extras.phones, and extras.multiple_phones is true when there is more than one.

**How do I look up a business?**

Set mode to lookup and put names or trade words in queries, with a state, city or ZIP. Lookups read the live listings; pick a location, since a name without one has nowhere to search.

**How am I charged?**

One 'Rated business lead' event per row returned, plus, when those options are on, one 'BBB profile details' event per business whose profile is read, one 'Contact details found' event per row that gets a missing website or phone by name lookup, and one 'E-mail found' event per row whose e-mail is found on its website. Notices are free.

**Can I keep only accredited or top-rated businesses?**

Yes. Turn on 'Accredited businesses only' and set 'Minimum rating score' (A+ is 97 and up, A 94, A- 91, B- about 80). The filters are applied before the maxResults cap, so the cap counts only rows that pass.

### Guides & use cases

Written up on **[scrapebench.dev](https://scrapebench.dev)** — the bench that runs and verifies this actor against the live source every night:

- **How-to:** [How to run US Home Services Business Leads Scraper (Rated, with Phone)](https://scrapebench.dev/guides/how-to-us-bbb-business-leads-scraper/)
- **Use case:** [Austin roofing companies with owner names, phones and ratings](https://scrapebench.dev/use-cases/austin-roofing-companies-with-owners/)

More actors, coverage and nightly verification results: **[scrapebench.dev](https://scrapebench.dev)**

### Works with AI assistants (MCP)

Callable as an MCP tool, so Claude, Cursor, VS Code Copilot and other MCP clients can run it directly. Grab the config from the [MCP tab](https://apify.com/scrapebench/us-bbb-business-leads-scraper/api/mcp) on this page — Apify hosts the server and keeps that snippet current, and OAuth signs you in on first connect, so no API token goes in your config file.

Then just ask:

> "List rated roofing companies in Los Angeles, California with their phone numbers and accreditation."

That is States 'CA', Trade 'Roofing', City 'Los Angeles'. Keep maxResults small on a first call. Runs started this way bill exactly like any other run.

### Use it from an AI agent (Agent Skill)

The free [`scrapebench-b2b-leads`](https://github.com/scrapebenchhq/apify-actor-skills/tree/main/scrapebench-b2b-leads) skill teaches Claude Code and other agents to find the right scrapebench Actor for the task and run it. Copy the folder into `~/.claude/skills/`, set `APIFY_TOKEN`, and ask in plain words.

### Data & lawful use

This actor collects publicly available information that each listed business and the Better Business Bureau (BBB) organization that lists it publishes for public
lookup — licence records, business listings and the contact details professionals list there.
Some of it identifies individuals (sole proprietors, licence holders, agents), so treat any
names, phone numbers and emails in your results as personal data.

When you run this actor, you decide what is collected and what it is used for, so you are the
controller of that data and we act only as your processor (Apify Standard Actor Contract).
You need a lawful basis for your use, must honour opt-out and deletion requests, and must
follow the marketing rules that apply to you (CAN-SPAM, TCPA, GDPR, CCPA and similar).
Don't use the output for unsolicited bulk messaging, for screening covered by the FCRA, or
for anything the source's own terms forbid.

Your results are stored in your own Apify account. We don't keep a copy of your results and
don't sell or share them.

### Disclaimer

This is an independent tool. It is not affiliated with, endorsed by or sponsored by
each listed business and the Better Business Bureau (BBB) organization that lists it. Names and marks are used only to describe the data source. Records are
provided as published by the source and may be out of date or incomplete. For anything
consequential (hiring, a permit, a legal decision), confirm the record with the issuing
agency. You are responsible for making sure your use complies with applicable law and the
source's terms.

### Need help?

Open an issue on this actor's **Issues** tab and we'll respond there. Bug reports, missing
fields and feature requests are all welcome. Guides and examples: [scrapebench.dev](https://scrapebench.dev).

If you are a person named in this data and want your record removed from our copy, email
apify-help@scrapebench.dev; the source agency remains the official record.

Your run may be used to improve our services. If something looks off, or you want this actor to fit your use better, please share your run data with us: [Apify Console → Settings → Security → Share run data with developers](https://console.apify.com/settings/security). It lets us see exactly what went wrong and keep improving the actor.

If this actor saved you time, a short review on its Store page helps other buyers find it.

# Actor input Schema

## `mode` (type: `string`):

export: no names, just filters; returns the whole matching list. lookup: put business names in 'queries'. auto picks the mode for you.

## `query` (type: `string`):

A business name (or listing number) to look up live. Kept alongside 'queries' for saved tasks.

## `queries` (type: `array`):

A business name (or listing number) to look up live. Several values in one run; combined with 'query'.

## `state` (type: `string`):

Only listings in this state. Kept alongside 'states' for saved tasks.

## `states` (type: `array`):

Only listings in this state. Several values in one run; combined with 'state'.

## `city` (type: `string`):

Only listings in this city. Kept alongside 'cities' for saved tasks.

## `cities` (type: `array`):

Only listings in this city. Several values in one run; combined with 'city'.

## `zip` (type: `string`):

Only listings in this ZIP code. Kept alongside 'zips' for saved tasks.

## `zips` (type: `array`):

Only listings in this ZIP code. Several values in one run; combined with 'zip'.

## `categories` (type: `array`):

Only rows from this trade (one or more). Available: Cleaning, Concrete and masonry, Electricians, Flooring, Garage doors, General contractors, HVAC, Landscaping and fencing, Movers, Painting, Pest control, Plumbing, Roofing, Windows and siding.

## `includeContacts` (type: `boolean`):

Add each business's phone, website and street address where available, looked up by business name. Charged as a separate 'Contact details found' event per row that gets one; a row without a contact costs only the row price. Only fields the source left empty are filled. Turn off for the list alone.

## `findEmails` (type: `boolean`):

For a business with a website and no e-mail, look for one on the business's own website. Charged as a separate 'E-mail found' event only when one is found. On a large export this adds time; a run that reaches its time limit delivers the remaining rows without the check and says how many. Turn off for the fastest export.

## `accreditedOnly` (type: `boolean`):

Keep only businesses that are accredited. Applied before the maxResults cap, so the cap counts accredited rows.

## `includeProfiles` (type: `boolean`):

Opens each delivered business's BBB profile and adds what it publishes: website, e-mail, owner and contact names with titles, years in business, business start / incorporation / accreditation dates, entity type, licence numbers, complaint and review counts, other phones, fax and websites, opening hours, products and services, description and payment methods. Charged as a separate 'BBB profile details' event per business whose profile is read; a profile that does not answer is not charged. Adds about a second per business; a run that reaches its time limit delivers the rest without and says how many.

## `minRatingScore` (type: `integer`):

Keep only businesses whose 0-100 rating score is at least this. Measured bands: A+ 97 and up, A 94-96, A- 91-93, B- about 80, C about 70-77, F 54-59; businesses with no rating count as 0. 1 = no filter. Applied before the maxResults cap, so the cap counts rows that pass.

## `maxResults` (type: `integer`):

Per query in lookup mode; per run in export mode.

## `proxyConfiguration` (type: `object`):

Used only for live lookups; exports read the stored snapshot.

## Actor input object example

```json
{
  "mode": "auto",
  "queries": [],
  "states": [],
  "cities": [],
  "zips": [],
  "categories": [],
  "includeContacts": true,
  "findEmails": true,
  "accreditedOnly": false,
  "includeProfiles": false,
  "minRatingScore": 1,
  "maxResults": 500,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One row per business listing; notices are free.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapebench/us-bbb-business-leads-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("scrapebench/us-bbb-business-leads-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call scrapebench/us-bbb-business-leads-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapebench/us-bbb-business-leads-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/s3ddJSApPx4t5el1t/builds/ucHO4C05A6xK3YTX8/openapi.json
