# BBB Scraper - Business Leads, Ratings & Accreditation (`scrapesage/bbb-scraper`) Actor Scrape Better Business Bureau businesses by category & city: name, BBB rating (A+ to F), accreditation, phone, full address, website, email, years in business, complaints, customer reviews & owner contacts. US & Canada B2B lead generation. Export JSON, CSV, Excel. - **URL**: https://apify.com/scrapesage/bbb-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $4.00 / 1,000 business leads 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 ## BBB Scraper — Better Business Bureau Business Leads, Ratings & Accreditation Extract **complete Better Business Bureau business data** at scale — the fields that make a US/Canada B2B lead actionable: **business name, BBB rating (A+ to F), accreditation status, phone, full address, website, years in business, owner/principal contacts, complaints, customer reviews, licenses and service area.** Optionally turn every listing into a **ready-to-contact lead** by crawling each business's own website for **emails and social profiles**, with a 0–100 **lead score**. Search by **category + city** (`Roofing Contractors` in `Dallas, TX`), paste BBB search or profile URLs, and export structured JSON, CSV or Excel. No login, no API key — reliable extraction with automatic Cloudflare handling over US residential proxies. ### Why this BBB scraper? BBB is one of the most trusted US business directories — and a goldmine for B2B prospecting, because every profile is a real, vetted business with a rating, accreditation signal, phone and address. This actor reads BBB's full embedded business record (not just the visible card) and ships the **richest BBB dataset in the category**: | Data | Typical scrapers | This actor | |---|---|---| | Business name, category, phone, full address | ✅ | ✅ | | **BBB rating (A+ to F) + numeric rating score** | partial | ✅ | | **Accreditation status + accredited-since date** | ❌ | ✅ | | **Real business website** | ❌ | ✅ | | Years in business + business start / incorporation date | ❌ | ✅ | | **Owner / principal contacts (names + titles)** | ❌ | ✅ opt-in | | Complaint counts (3-yr & 12-mo) + customer review count & avg rating | ❌ | ✅ | | Licenses (number + issuing agency) | ❌ | ✅ opt-in | | Service area (cities served) | ❌ | ✅ opt-in | | **Contact emails + socials** (from the business website) | ❌ | ✅ opt-in | | **Lead score (0–100)** | ❌ | ✅ | | Monitor mode — only output new/changed businesses | ❌ | ✅ | ### Use cases - **B2B lead generation** — build targeted lists of real, vetted businesses by category and city with phone, website, owner name and (optionally) email. Score and prioritize with `leadScore`, filter to **BBB-accredited** or **A+ rated** prospects, then push into your CRM. - **Sales prospecting** — agencies and SaaS/insurance/financial teams that sell to local businesses can find every `HVAC`, `Roofing`, `Plumbing`, `Auto Repair`, `Law Firm` or `Dentist` in a metro — and reach the owner directly. - **Reputation & competitor intelligence** — track BBB ratings, accreditation, complaint volume and review scores across a market. - **Vendor & supplier vetting** — pull accreditation, years in business, complaints and licenses to qualify vendors at scale. - **Data enrichment** — paste a list of BBB profile URLs to enrich them with full contact and trust data. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **BBB Scraper**, enter one or more **search terms** (categories/keywords) and **locations** (or paste BBB URLs), and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "searchTerms": ["Roofing Contractors", "Plumbers"], "locations": ["Dallas, TX", "Austin, TX"], "maxResults": 100, "accreditedOnly": false, "minRating": "any", "includeDetails": true, "includeReviews": true, "enrichContacts": true, "monitorMode": false } ```` - **searchTerms** — categories or keywords (`Plumbers`, `HVAC`, `Lawyers`) or a specific business name. Combined with every location. - **locations** — `City, ST` strings (`Austin, TX`), ZIP/postal codes, or a state/province. Combined with every search term. - **startUrls** — direct BBB **search** pages (`/search?find_text=…&find_loc=…`) or **profile** pages (`/us/.../profile/...`). Profile URLs are always fully enriched. - **maxResults** *(default 100)* — total businesses across all searches. `0` = no limit. - **maxResultsPerSearch** — optional cap per term+location combination. - **accreditedOnly** — keep only BBB-accredited businesses. - **minRating** — keep only businesses at/above a BBB letter rating (`A+`, `A`, `B+`, …). - **includeDetails** *(default false)* — open each profile for website, owner contacts, years in business, complaints, reviews count, licenses, service area and the "About" overview. - **includeReviews** *(default false)* — add recent BBB customer reviews (requires details). - **enrichContacts** *(default false)* — crawl each business's own website for emails and socials. BBB rarely publishes emails — this is how you get them. - **monitorMode** *(default false)* — only output businesses that are new or changed (e.g. rating change) since the last run. Perfect for scheduled lead pipelines. - **proxyConfiguration** — keep the default Apify Residential (US) for the best reliability on profile pages. ### Output One record per business (`type: "business"`). List-only runs return the core fields; turning on details/reviews/enrichment fills the rest: ```json { "type": "business", "businessId": "1000193414", "bbbId": "0825", "bbbChapter": "BBB Heart of Texas", "businessName": "Ecotech Roofing and Construction", "category": "Roofing Contractors", "bbbRating": "A+", "ratingScore": 100, "accredited": true, "phone": "(214) 555-0188", "address": "1200 Commerce St, Dallas, TX 75202", "city": "Dallas", "state": "TX", "zip": "75202", "country": "US", "latitude": 32.7791, "longitude": -96.7954, "profileUrl": "https://www.bbb.org/us/tx/dallas/profile/roofing-contractors/ecotech-roofing-and-construction-0875-1000193414", "website": "https://ecotechroofing.com", "email": null, "yearsInBusiness": 17, "businessStarted": "2009-04-01", "dateAccredited": "2014-03-25", "numberOfEmployees": 24, "description": "Full-service residential & commercial roofing contractor.", "principalContacts": [{ "name": "Robert Burnley", "title": "Owner/Manager" }], "licenses": [{ "number": "RCAT-12345", "agency": "Roofing Contractors Association of Texas", "expiration": "2027-01-31" }], "serviceArea": "Dallas, TX; Plano, TX; Frisco, TX; Garland, TX", "complaintCount": 2, "complaintsLast3Years": 1, "customerReviewCount": 38, "averageStarRating": 4.7, "leadScore": 84, "searchTerm": "Roofing Contractors", "searchLocation": "Dallas, TX", "scrapedAt": "2026-06-26T12:00:00.000Z" } ``` ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly to keep a city + category lead list fresh. Combine with **monitor mode** to drip only new businesses into your pipeline. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/bbb-scraper').call({ searchTerms: ['HVAC'], locations: ['Phoenix, AZ'], maxResults: 100, includeDetails: true, enrichContacts: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} BBB business leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new business leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored search finds new businesses. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. Call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find A+ accredited roofing contractors in Dallas with a website and owner contact" and let it run this scraper for you. ### More scrapers from scrapesage Build a complete **local-business lead-gen stack**: - **[Google Maps Scraper](https://apify.com/scrapesage/google-maps-scraper)** — places, business leads, emails & contacts. - **[Thumbtack Scraper](https://apify.com/scrapesage/thumbtack-scraper)** — home-service pro leads, reviews & hire data. - **[Expertise.com Scraper](https://apify.com/scrapesage/expertise-scraper)** — vetted local-business leads across US verticals. - **[BuildZoom Scraper](https://apify.com/scrapesage/buildzoom-scraper)** — contractor directory leads. - **[Website Contact Scraper](https://apify.com/scrapesage/website-contact-scraper)** — emails, phones & socials from any domain list. - **[LinkedIn Company Scraper](https://apify.com/scrapesage/linkedin-company-scraper)** — firmographics & B2B company leads. - **[TaxBuzz Scraper](https://apify.com/scrapesage/taxbuzz-scraper)** — tax & accounting professional leads. - **[Care.com Scraper](https://apify.com/scrapesage/care-com-scraper)** — caregiver & care-business leads. ### Tips - **Best leads first**: set `accreditedOnly: true` and/or `minRating: "A"` to focus on vetted, high-trust businesses — accredited profiles also carry the richest data (website, owner, years in business, dates). - **Go deep on a market**: split by sub-category (e.g. `Residential Roofing`, `Commercial Roofing`) and by city/ZIP to exhaust a metro. - **Emails**: turn on `enrichContacts` — BBB itself rarely lists emails, so the actor pulls them from each business's own website. - **Cost control**: details, reviews and enrichment are all opt-in; list-only runs are fast and cheap. - **Recurring leads**: pair **monitor mode** + **Schedules** to receive only newly listed or changed businesses each day. ### FAQ **How do I scrape BBB businesses for a specific city?** Put the category in `searchTerms` (`Plumbers`) and the city in `locations` (`Austin, TX`). Each term is combined with each location. **Does it work without the BBB API?** Yes. No API key or login needed — the actor reads BBB's public server-rendered data. **Where do the emails come from?** BBB rarely publishes business emails. With `enrichContacts` on, the actor visits each business's own public website and extracts publicly listed contact emails — the same thing a human visitor would see. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I monitor new businesses automatically?** Turn on `monitorMode`, set a `monitorKey`, and create a [Schedule](https://docs.apify.com/platform/schedules). Each run outputs only new or changed businesses. **A field is null — why?** BBB holds richer data for accredited/established businesses than for unrated (NR) listings. Fields like owner contacts, years in business, hours and service area are populated when BBB has them; email is rarely published by BBB (use `enrichContacts`). Fields are `null` only when the data isn't on the page. **Is scraping BBB legal?** This actor collects publicly available data only. You are responsible for using the data in compliance with applicable laws (GDPR/CCPA for personal data) and BBB's terms. ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `searchTerms` (type: `array`): What to search for on BBB — a category or keyword such as Plumbers, Roofing Contractors, Auto Repair, HVAC, Lawyers, or a specific business name. Each term is combined with every location below. ## `locations` (type: `array`): Where to search — a City, ST string (Austin, TX, Chicago, IL), a ZIP/postal code, or a US state / Canadian province. Each location is combined with every search term. Leave empty to search nationwide for a named business. ## `startUrls` (type: `array`): Direct BBB URLs to scrape in addition to searches: search pages (https://www.bbb.org/search?find\_text=...\&find\_loc=...) or business profile pages (https://www.bbb.org/us/.../profile/...). Profile URLs are always fully enriched. ## `maxResults` (type: `integer`): Maximum number of businesses to scrape across all searches. Use 0 for no limit (exhaust every search — only with narrow searches). ## `maxResultsPerSearch` (type: `integer`): Optional cap per individual search term + location combination. 0 = no per-search cap (still bounded by Max businesses). ## `accreditedOnly` (type: `boolean`): Keep only businesses that are BBB Accredited (paying members that meet BBB standards). ## `minRating` (type: `string`): Keep only businesses at or above this BBB letter rating. ## `includeDetails` (type: `boolean`): Open each business profile for the complete record: website, email, additional phones, years in business, date incorporated, accredited-since, hours, number of employees, owner / principal contacts, BBB file details, complaint count and the full "About" overview. Adds one request per business. ## `includeReviews` (type: `boolean`): Extract recent BBB customer reviews for each business (author, rating, date, text). Requires business details. ## `maxReviewsPerBusiness` (type: `integer`): How many recent customer reviews to keep per business when "Include customer reviews" is on. ## `enrichContacts` (type: `boolean`): For businesses that list a website, visit it (home + contact/about, up to 3 pages) and extract public contact emails, phone numbers, a contact-form URL and social profiles (LinkedIn, Instagram, Facebook, Twitter/X, YouTube). Requires business details. ## `monitorMode` (type: `boolean`): Remember businesses seen on previous runs (in a named key-value store) and output only businesses that are new or changed (e.g. rating change) since last time. Perfect for scheduled lead pipelines — pair with Apify Schedules to drip only fresh leads into your CRM. ## `monitorKey` (type: `string`): Names the persistent monitor store so you can keep separate watch-lists (e.g. austin-plumbers). Reuse the same key across scheduled runs to keep deduplicating against history. ## `maxConcurrency` (type: `integer`): How many browser pages to run in parallel. 3–6 is a good balance of speed and reliability; Crawlee auto-scales down if memory is limited. ## `proxyConfiguration` (type: `object`): Proxies to use. US residential proxies are recommended for the highest reliability on BBB profile pages. The default (Apify Residential, US) works out of the box. ## Actor input object example ```json { "searchTerms": [ "Plumbers" ], "locations": [ "Austin, TX" ], "maxResults": 100, "maxResultsPerSearch": 0, "accreditedOnly": false, "minRating": "any", "includeDetails": false, "includeReviews": false, "maxReviewsPerBusiness": 8, "enrichContacts": false, "monitorMode": false, "monitorKey": "default", "maxConcurrency": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `results` (type: `string`): All scraped BBB business records as JSON items in the default dataset. # 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 = { "searchTerms": [ "Plumbers" ], "locations": [ "Austin, TX" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/bbb-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 = { "searchTerms": ["Plumbers"], "locations": ["Austin, TX"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/bbb-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 '{ "searchTerms": [ "Plumbers" ], "locations": [ "Austin, TX" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call scrapesage/bbb-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/bbb-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "BBB Scraper - Business Leads, Ratings & Accreditation", "description": "Scrape Better Business Bureau businesses by category & city: name, BBB rating (A+ to F), accreditation, phone, full address, website, email, years in business, complaints, customer reviews & owner contacts. US & Canada B2B lead generation. Export JSON, CSV, Excel.", "version": "1.0", "x-build-id": "ptRTSpBZ6Zw7HaGLJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~bbb-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-bbb-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/scrapesage~bbb-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-bbb-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/scrapesage~bbb-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-bbb-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", "properties": { "searchTerms": { "title": "Search terms (category or business name)", "type": "array", "description": "What to search for on BBB — a category or keyword such as Plumbers, Roofing Contractors, Auto Repair, HVAC, Lawyers, or a specific business name. Each term is combined with every location below.", "items": { "type": "string" } }, "locations": { "title": "Locations (city & state / province)", "type": "array", "description": "Where to search — a City, ST string (Austin, TX, Chicago, IL), a ZIP/postal code, or a US state / Canadian province. Each location is combined with every search term. Leave empty to search nationwide for a named business.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Direct BBB URLs to scrape in addition to searches: search pages (https://www.bbb.org/search?find_text=...&find_loc=...) or business profile pages (https://www.bbb.org/us/.../profile/...). Profile URLs are always fully enriched.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxResults": { "title": "Max businesses", "minimum": 0, "type": "integer", "description": "Maximum number of businesses to scrape across all searches. Use 0 for no limit (exhaust every search — only with narrow searches).", "default": 100 }, "maxResultsPerSearch": { "title": "Max businesses per search", "minimum": 0, "type": "integer", "description": "Optional cap per individual search term + location combination. 0 = no per-search cap (still bounded by Max businesses).", "default": 0 }, "accreditedOnly": { "title": "BBB-accredited businesses only", "type": "boolean", "description": "Keep only businesses that are BBB Accredited (paying members that meet BBB standards).", "default": false }, "minRating": { "title": "Minimum BBB rating", "enum": [ "any", "A+", "A", "A-", "B+", "B", "B-", "C+", "C", "C-", "D+", "D", "D-" ], "type": "string", "description": "Keep only businesses at or above this BBB letter rating.", "default": "any" }, "includeDetails": { "title": "Scrape full business details", "type": "boolean", "description": "Open each business profile for the complete record: website, email, additional phones, years in business, date incorporated, accredited-since, hours, number of employees, owner / principal contacts, BBB file details, complaint count and the full \"About\" overview. Adds one request per business.", "default": false }, "includeReviews": { "title": "Include customer reviews", "type": "boolean", "description": "Extract recent BBB customer reviews for each business (author, rating, date, text). Requires business details.", "default": false }, "maxReviewsPerBusiness": { "title": "Max reviews per business", "minimum": 1, "maximum": 100, "type": "integer", "description": "How many recent customer reviews to keep per business when \"Include customer reviews\" is on.", "default": 8 }, "enrichContacts": { "title": "Enrich emails & socials from business website", "type": "boolean", "description": "For businesses that list a website, visit it (home + contact/about, up to 3 pages) and extract public contact emails, phone numbers, a contact-form URL and social profiles (LinkedIn, Instagram, Facebook, Twitter/X, YouTube). Requires business details.", "default": false }, "monitorMode": { "title": "Monitor mode — only output new businesses", "type": "boolean", "description": "Remember businesses seen on previous runs (in a named key-value store) and output only businesses that are new or changed (e.g. rating change) since last time. Perfect for scheduled lead pipelines — pair with Apify Schedules to drip only fresh leads into your CRM.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Names the persistent monitor store so you can keep separate watch-lists (e.g. austin-plumbers). Reuse the same key across scheduled runs to keep deduplicating against history.", "default": "default" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "How many browser pages to run in parallel. 3–6 is a good balance of speed and reliability; Crawlee auto-scales down if memory is limited.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxies to use. US residential proxies are recommended for the highest reliability on BBB profile pages. The default (Apify Residential, US) works out of the box.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } } ```