# BuildZoom Scraper (`parsebird/buildzoom-scraper`) Actor
Scrape contractor data from BuildZoom. Search by city and trade, filter by construction type and project value. Extract BZ scores, licenses, permits, reviews, insurance, and contact info for 4M+ US contractors.
- **URL**: https://apify.com/parsebird/buildzoom-scraper.md
- **Developed by:** [ParseBird](https://apify.com/parsebird) (community)
- **Categories:** Lead generation, Real estate, Jobs
- **Stats:** 4 total users, 2 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet
## Pricing
from $4.00 / 1,000 buildzoom contractor listings
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/platform/actors/running/actors-in-store#pay-per-event
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".
## 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.
The best way to integrate Actors is as follows.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).
If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).
For usage examples, see the [API](#api) section below.
For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).
# README
### BuildZoom Scraper
Scrape contractor data from [BuildZoom](https://www.buildzoom.com/), the largest contractor database in the US with 4M+ licensed contractors and 300M+ building permits. Search by city and trade, filter by construction type and project value. Extract BZ scores, licenses, insurance, bonds, reviews, and contact info.
Source contractor leads, benchmark competitors, and verify licenses across the largest US contractor database with 4M+ profiles enriched by government permit data.
##### Copy to your AI assistant
Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.
````
parsebird/buildzoom-scraper on Apify. Call: ApifyClient("TOKEN").actor("parsebird/buildzoom-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items for results. Key inputs: city (string, e.g. "miami", "dallas-tx", "new-york-ny"), trade (string, "general-contractors"/"roofers"/"electricians"/"plumbers"/"architects"/"home-builders"/"kitchen-and-bathroom-remodeling"/"home-addition"/"solar-contractors"/"foundation\_contractors"), constructionType (string, ""/"residential"/"commercial"), avgProjectValue (string, ""/"10000"/"50000"/"100000"/"100001"), maxPages (integer), maxResults (integer), includeDetails (boolean). Full actor spec: fetch build via GET https://api.apify.com/v2/acts/parsebird~buildzoom-scraper (Bearer TOKEN). Get token: https://console.apify.com/account/integrations
````
### What does BuildZoom Scraper do?
This Actor scrapes [buildzoom.com](https://www.buildzoom.com/), the largest contractor directory in the United States. It supports two modes:
**Listing mode** (default, fast and cheap):
| Field | Example |
|-------|---------|
| Contractor name | Cf Construction and Remodeling, Inc |
| Profile URL | https://www.buildzoom.com/contractor/cf-construction-and-remodeling-inc |
| BZ Score | 180 |
| Price range | $25,000 - $1,000,000 |
| Full address | 3532 SW 113th Ct, Miami, FL 33165 |
| City / State / ZIP | Miami / FL / 33165 |
| Phone number | (904) 513-9494 |
| Total projects | 149 |
| Rating | 5.0 |
| Review count | 6 |
| Project breakdown | New constructions, kitchen remodels, roofing, etc. |
| Description | Premier residential General Contractor... |
**Detail mode** (adds per contractor):
| Field | Example |
|-------|---------|
| License numbers | CGC1507638, CMC1251411 |
| License status | Active |
| License types | ["Certified General Contractor", "Roofing"] |
| Insurance amount | $2,000,000 |
| Insurance provider | Kinsale Insurance Co |
| Bond amount | $12,000,000 |
| Bond provider | Nielson, Hoover & Company |
| Verified license | true |
| Last updated | Feb 06, 2026 |
| Photos count | 24 |
### Why scrape BuildZoom?
- **Lead generation** — Build targeted lists of licensed contractors by city, trade, and project value for B2B sales
- **Competitive analysis** — Benchmark BZ scores, pricing, and project volume across competitors in any market
- **License verification** — Verify contractor credentials, insurance coverage, and bond status at scale
- **Market research** — Analyze contractor density, specializations, and pricing trends across US cities
- **Recruiting** — Identify top-rated contractors and agencies in specific trades and locations
- **Due diligence** — Screen contractors before hiring with verified license and insurance data
- **Directory building** — Feed contractor data into your own marketplace or aggregation platform
### How to use
1. Go to the [BuildZoom Scraper](https://apify.com/parsebird/buildzoom-scraper) page on Apify Store
2. Click **Try for free**
3. Configure your input:
- **City** — City slug (e.g. "miami", "dallas-tx", "new-york-ny", "los-angeles")
- **Trade** — General Contractors, Roofers, Electricians, Plumbers, Architects, etc.
- **Construction Type** — All, Residential, or Commercial
- **Avg Project Value** — Filter by typical project budget range
- **Sort By** — Top 10, BZ Score, Verified Projects, Client Ratings, or Avg Project Value
4. Click **Start** and wait for the run to finish
5. Download your data in JSON, CSV, Excel, or connect via API
> **Note:** City slugs follow the BuildZoom URL format. Most cities use `city-state` format like `dallas-tx`, `san-francisco-ca`, `new-york-ny`. Some major cities use just the name: `miami`, `chicago`, `houston`, `seattle`. Check the BuildZoom website URL for the correct slug.
### Input parameters
| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `city` | string | `"miami"` | City slug from BuildZoom URLs (e.g. "miami", "dallas-tx") |
| `trade` | string | `"general-contractors"` | Contractor trade: `general-contractors`, `roofers`, `electricians`, `plumbers`, `architects`, `home-builders`, `kitchen-and-bathroom-remodeling`, `home-addition`, `solar-contractors`, `foundation_contractors` |
| `constructionType` | string | `""` | Filter: `residential`, `commercial`, or empty for all |
| `avgProjectValue` | string | `""` | Filter: `10000` (up to $10K), `50000`, `100000`, `100001` ($100K+), or empty |
| `sortBy` | string | `""` | Sort: `score`, `projects`, `ratings`, `value`, or empty (Top 10 default) |
| `maxPages` | integer | `5` | Max listing pages (25 contractors per page) |
| `maxResults` | integer | `50` | Max contractors to return (0 = unlimited) |
| `includeDetails` | boolean | `false` | Fetch profile pages for license, insurance, and bond data |
### Output data
**Listing mode example:**
```json
{
"contractorName": "Cf Construction and Remodeling, Inc",
"slug": "cf-construction-and-remodeling-inc",
"url": "https://www.buildzoom.com/contractor/cf-construction-and-remodeling-inc",
"bzScore": 180,
"priceRange": "$25,000 - $1,000,000",
"fullAddress": "3532 SW 113th Ct, Miami, FL 33165",
"city": "Miami",
"state": "FL",
"zipCode": "33165",
"phoneNumber": "(904) 513-9494",
"phoneExt": "487",
"totalProjects": 149,
"totalProjectsVerified": 149,
"rating": 5.0,
"reviewCount": 6,
"newConstructions": 5,
"kitchenRemodels": 12,
"multiRoomRemodels": 8,
"description": "Premier residential General Contractor...",
"scrapedAt": "2026-04-06T12:00:00.000Z"
}
````
**Detail mode adds:**
```json
{
"licenseNumbers": "CGC1507638, CMC1251411, CCC1330397",
"licenseStatus": "Active",
"licenseTypes": ["Certified General Contractor", "Certified Mechanical Contractor", "Certified Roofing Contractor"],
"insuranceAmount": "2,000,000",
"insuranceProvider": "Kinsale Insurance Co",
"bondAmount": "12,000,000",
"bondProvider": "Nielson, Hoover & Company",
"hasVerifiedLicense": true,
"lastUpdated": "Feb 06, 2026",
"photosCount": 24
}
```
### Use with the Apify API
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("parsebird/buildzoom-scraper").call(run_input={
"city": "miami",
"trade": "general-contractors",
"constructionType": "residential",
"maxResults": 100,
"includeDetails": True,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(f"{item['contractorName']} - BZ: {item['bzScore']} - {item.get('priceRange', 'N/A')}")
```
### Pricing
This Actor uses **Pay-per-event** pricing:
| Event | Cost | Rate |
|-------|------|------|
| `buildzoom-contractor-listing` | $0.002 | $2 per 1,000 contractors |
| `buildzoom-contractor-detail` | $0.005 | $5 per 1,000 contractors |
**Listing mode** charges only `buildzoom-contractor-listing` per contractor found. **Detail mode** charges only `buildzoom-contractor-detail` per contractor enriched (no double-charging).
**Cost examples (listing mode):**
- 50 contractors: $0.10
- 200 contractors: $0.40
- 1,000 contractors: $2.00
**Cost examples (detail mode):**
- 50 contractors: $0.25
- 200 contractors: $1.00
- 1,000 contractors: $5.00
You only pay for the contractors actually returned.
### Tips and best practices
- **Start small** — Set `maxResults` to 5-10 with `includeDetails` enabled to preview the data before running a full scrape
- **City slug format** — Check the BuildZoom URL for your target city to get the exact slug. Most use `city-state` (e.g. `dallas-tx`), some use just the city name (e.g. `miami`)
- **Use listing mode for lead lists** — Listing mode already includes name, address, phone, BZ score, price range, and project counts — enough for most lead generation use cases
- **Detail mode for due diligence** — Enable detail mode when you need verified license numbers, insurance coverage, and bond information
- **Scheduling** — Set up weekly runs to track new contractors or changes in BZ scores and project counts
### Integrations
Connect this Actor to your workflow:
- **Google Sheets** — Export results directly
- **Webhooks** — Trigger actions when new data arrives
- **API** — Access data programmatically via the Apify API
- **Zapier / Make** — Automate downstream workflows
### Limitations
- BuildZoom is US-only. The scraper requires US IP access, which Apify provides via its residential proxies when running on the platform.
- Services offered, permit history, and employee data are loaded via JavaScript on detail pages and are not extracted in this version. The listing page data + license/insurance/bond from detail pages covers the most valuable data points.
- Some contractors may not have all fields (rating, price range, description) depending on their profile completeness.
- Detail pages are fetched sequentially with small delays to avoid rate limiting.
# Actor input Schema
## `city` (type: `string`):
City name (e.g. 'New York, NY', 'Miami', 'San Francisco, CA', 'Chicago', 'Dallas, TX'). Also accepts URL slugs like 'new-york-ny'.
## `trade` (type: `string`):
Type of contractor to search for.
## `constructionType` (type: `string`):
Filter by construction type.
## `avgProjectValue` (type: `string`):
Filter by average project value range.
## `sortBy` (type: `string`):
How to sort the results.
## `maxPages` (type: `integer`):
Maximum number of listing pages to scrape (25 contractors per page).
## `maxResults` (type: `integer`):
Maximum number of contractors to return (0 = unlimited).
## `includeDetails` (type: `boolean`):
Fetch each contractor's profile page for license details, insurance/bond info, and additional data. Costs more per result.
## Actor input object example
```json
{
"city": "New York, NY",
"trade": "general-contractors",
"constructionType": "",
"avgProjectValue": "",
"sortBy": "",
"maxPages": 5,
"maxResults": 50,
"includeDetails": false
}
```
# Actor output Schema
## `dataset` (type: `string`):
No description
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"city": "New York, NY"
};
// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/buildzoom-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "city": "New York, NY" }
# Run the Actor and wait for it to finish
run = client.actor("parsebird/buildzoom-scraper").call(run_input=run_input)
# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
print(item)
# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start
```
## CLI example
```bash
echo '{
"city": "New York, NY"
}' |
apify call parsebird/buildzoom-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=parsebird/buildzoom-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "BuildZoom Scraper",
"description": "Scrape contractor data from BuildZoom. Search by city and trade, filter by construction type and project value. Extract BZ scores, licenses, permits, reviews, insurance, and contact info for 4M+ US contractors.",
"version": "1.8",
"x-build-id": "8FHKjbleFdgvc8pgp"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/parsebird~buildzoom-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-parsebird-buildzoom-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/parsebird~buildzoom-scraper/runs": {
"post": {
"operationId": "runs-sync-parsebird-buildzoom-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/parsebird~buildzoom-scraper/run-sync": {
"post": {
"operationId": "run-sync-parsebird-buildzoom-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"city"
],
"properties": {
"city": {
"title": "City",
"type": "string",
"description": "City name (e.g. 'New York, NY', 'Miami', 'San Francisco, CA', 'Chicago', 'Dallas, TX'). Also accepts URL slugs like 'new-york-ny'.",
"default": "New York, NY"
},
"trade": {
"title": "Contractor Trade",
"enum": [
"general-contractors",
"architects",
"electricians",
"roofers",
"plumbers",
"home-builders",
"kitchen-and-bathroom-remodeling",
"home-addition",
"solar-contractors",
"foundation_contractors"
],
"type": "string",
"description": "Type of contractor to search for.",
"default": "general-contractors"
},
"constructionType": {
"title": "Construction Type",
"enum": [
"",
"residential",
"commercial"
],
"type": "string",
"description": "Filter by construction type.",
"default": ""
},
"avgProjectValue": {
"title": "Avg. Project Value",
"enum": [
"",
"10000",
"50000",
"100000",
"100001"
],
"type": "string",
"description": "Filter by average project value range.",
"default": ""
},
"sortBy": {
"title": "Sort By",
"enum": [
"",
"score",
"projects",
"ratings",
"value"
],
"type": "string",
"description": "How to sort the results.",
"default": ""
},
"maxPages": {
"title": "Max Pages",
"minimum": 1,
"maximum": 500,
"type": "integer",
"description": "Maximum number of listing pages to scrape (25 contractors per page).",
"default": 5
},
"maxResults": {
"title": "Max Results",
"minimum": 0,
"type": "integer",
"description": "Maximum number of contractors to return (0 = unlimited).",
"default": 50
},
"includeDetails": {
"title": "Include Detail Pages",
"type": "boolean",
"description": "Fetch each contractor's profile page for license details, insurance/bond info, and additional data. Costs more per result.",
"default": false
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```