# BBB.org Scraper - Low-cost๐ฒ๐ฅ๐ข๐ก (`delectable_incubator/bbb-org-scraper---low-cost`) Actor
Scrape business listings from BBB.org ๐๐ข with a powerful Better Business Bureau scraper.
Extract company names, addresses, phone numbers, accreditation status, and more by keyword and location.
Ideal for lead generation, local market research, and building structured business datasets ๐๐
- **URL**: https://apify.com/delectable\_incubator/bbb-org-scraper---low-cost.md
- **Developed by:** [Prime Scrape](https://apify.com/delectable_incubator) (community)
- **Categories:** Lead generation, Developer tools, Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
from $0.00005 / actor start
This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.
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
---
### BBB Business Directory Scraper ๐ข๐๐
The BBB Business Directory Scraper is a fast, reliable, and scalable automation tool designed to extract structured business listings directly from the Better Business Bureau (BBB) directory.
It transforms local business search results into clean, structured datasets ready for market research, lead generation, competitor analysis, and data-driven applications.
---
### BBB Business Directory Scraper ๐ง ๐๐
This scraper automatically extracts business data from the BBB directory using keyword and location-based searches.
Ideal for marketers, sales teams, analysts, and developers working with local business intelligence and structured datasets.
---
### ๐ฏ What This Scraper Does
Simply provide a keyword, location, sorting option, and the number of results to extract โ the scraper handles the rest.
โ
Extracts business listings from the BBB directory
โ
Supports keyword + location-based searches
โ
Handles pagination automatically
โ
Collects detailed business information
โ
Retrieves ratings, accreditation & contact data
โ
Clean, structured, analysis-ready datasets
โ
Ideal for lead generation & market intelligence
---
### ๐ Data Extracted
๐งพ Business Fields
| Field | Description |
| ------------------------ | ------------------------------- |
| ๐ `id` | Unique listing ID |
| ๐ข `businessName` | Business name |
| ๐ `address` | Street address |
| ๐ `city` | City |
| ๐บ `state` | State |
| ๐ฎ `postalcode` | ZIP / postal code |
| ๐ `categories` | Business categories |
| ๐ `phone` | Phone number(s) |
| โญ `rating` | BBB rating |
| ๐
`bbbMember` | BBB membership status |
| ๐ `accreditationStatus` | Accreditation status |
| ๐ `distance` | Distance from searched location |
| ๐ `location` | Coordinates (lat, long) |
| ๐ `businessWebsite` | Business website |
| ๐ `reportUrl` | BBB report page URL |
| ๐ `ratingScore` | Numerical rating score |
| ๐งพ `bbbName` | BBB office name |
---
### ๐ How to Use
1๏ธโฃ Configure Input
Provide your search parameters:
````
{
"keyword": \["roofing"],
"place": "New York",
"sort\_by": "Relevance",
"maxitems": 100
}
```
2๏ธโฃ Run the Actor
โข Perform keyword-based search on BBB
โข Extract business listings and details
โข Structure and clean the dataset
โข Stop when maxitems limit is reached
3๏ธโฃ Export the Dataset
Download your results in multiple formats:
โ
JSON
โ
CSV
โ
Excel
โ
XML
โ
HTML
---
### โ๏ธ Input Configuration
#### ๐ฅ Input Example
```
{
"keyword": \["plumber"],
"place": "Los Angeles",
"sort\_by": "Rating",
"maxitems": 50
}
```
#### Input Fields
| Field | Type | Description |
| ---------- | ------- | ------------------------------------ |
| `keyword` | array | Bulk Business search keyword |
| `place` | string | Location (city, region, or state) |
| `sort_by` | string | Sorting option (Relevance, Ratingโฆ) |
| `maxitems` | integer | Maximum number of results to extract |
---
### ๐ค Output Example
```
{
"id": "0121\_158093\_179835",
"businessName": "The Roof NY",
"address": "124 West 57th Street, 29th Floor",
"city": "New York",
"state": "NY",
"postalcode": "10019",
"rating": "A+",
"bbbMember": false,
"phone": \["(212) 707-8008"],
"location": "40.764736,-73.97817",
"distance": "0.1 mi",
"reportUrl": "/us/ny/new-york/profile/...",
"accreditationStatus": "Accredited"
}
````
---
### ๐ Output explanation
| Field | Description |
| --------------------- | ---------------------- |
| `businessName` | Company name |
| `address` | Business address |
| `rating` | BBB rating |
| `phone` | Contact number |
| `distance` | Distance from location |
| `reportUrl` | BBB profile link |
| `accreditationStatus` | Accreditation status |
---
### ๐ Why Use This Scraper?
๐ Market Research โ Analyze local business landscapes
๐ข Lead Generation โ Build targeted business lists
โญ Reputation Analysis โ Compare ratings & accreditation
๐ Local Insights โ Discover businesses by location
โ๏ธ Automation โ Schedule recurring data collection
๐ Data Pipelines โ Power dashboards & analytics
---
### โ ๏ธ Disclaimer
This tool is an independent solution and is not affiliated with or endorsed by the Better Business Bureau (BBB).
---
### ๐ธ Pricing
This scraper runs on a **pay per events subscription model**.
You only pay for **successful runs**.
๐ณ **Price:** $1.49 / 1000 results
---
### Related Actors
If you're interested in business scraping solutions, explore more tools:
(Coming soon)
---
### ๐ฌ Support
โญโญโญโญโญ Leave a 5-star rating if you like this tool
---
### ๐ PrimeScrape
Built for scalable web data extraction & automation
Contact for custom scraping solutions or enterprise requests via Apify or by email.
# Actor input Schema
## `keywords` (type: `array`):
Enter one or more keywords to search for business listings on BBB Business Directory ๐๐ผ.
## `place` (type: `string`):
Specify the city where you want to find Directories on BBB Business Directory ๐๏ธ๐ผ.
## `sort_by` (type: `string`):
Select a sort by option ๐
## `maxitems` (type: `integer`):
Set the maximum number of business listings you want to scrape ๐.
## Actor input object example
```json
{
"keywords": [
"Restaurants"
],
"place": "New York",
"sort_by": "Relevance",
"maxitems": 50
}
````
# Actor output Schema
## `overview` (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 = {
"keywords": [
"Restaurants"
],
"place": "New York",
"sort_by": "Relevance",
"maxitems": 50
};
// Run the Actor and wait for it to finish
const run = await client.actor("delectable_incubator/bbb-org-scraper---low-cost").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 = {
"keywords": ["Restaurants"],
"place": "New York",
"sort_by": "Relevance",
"maxitems": 50,
}
# Run the Actor and wait for it to finish
run = client.actor("delectable_incubator/bbb-org-scraper---low-cost").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 '{
"keywords": [
"Restaurants"
],
"place": "New York",
"sort_by": "Relevance",
"maxitems": 50
}' |
apify call delectable_incubator/bbb-org-scraper---low-cost --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=delectable_incubator/bbb-org-scraper---low-cost",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "BBB.org Scraper - Low-cost๐ฒ๐ฅ๐ข๐ก",
"description": "Scrape business listings from BBB.org ๐๐ข with a powerful Better Business Bureau scraper. \n\nExtract company names, addresses, phone numbers, accreditation status, and more by keyword and location. \n\nIdeal for lead generation, local market research, and building structured business datasets ๐๐",
"version": "0.0",
"x-build-id": "7EcIddqWz5ngCfsa5"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/delectable_incubator~bbb-org-scraper---low-cost/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-delectable_incubator-bbb-org-scraper---low-cost",
"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/delectable_incubator~bbb-org-scraper---low-cost/runs": {
"post": {
"operationId": "runs-sync-delectable_incubator-bbb-org-scraper---low-cost",
"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/delectable_incubator~bbb-org-scraper---low-cost/run-sync": {
"post": {
"operationId": "run-sync-delectable_incubator-bbb-org-scraper---low-cost",
"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": [
"keywords"
],
"properties": {
"keywords": {
"title": "Keywords to search for on BBB Business Directory ๐๐ผ",
"type": "array",
"description": "Enter one or more keywords to search for business listings on BBB Business Directory ๐๐ผ.",
"default": [
"Restaurants"
],
"items": {
"type": "string"
}
},
"place": {
"title": "City where you want to search for Directory on BBB Business Directory ๐๏ธ๐ผ",
"type": "string",
"description": "Specify the city where you want to find Directories on BBB Business Directory ๐๏ธ๐ผ.",
"default": "New York"
},
"sort_by": {
"title": "Select a sort by option ๐",
"enum": [
"Relevance",
"Rating",
"Distance"
],
"type": "string",
"description": "Select a sort by option ๐",
"default": "Relevance"
},
"maxitems": {
"title": "Maximum number of businesses to scrape ๐",
"type": "integer",
"description": "Set the maximum number of business listings you want to scrape ๐.",
"default": 50
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```