# Better Business Bureau Scraper \[PPR] (`zadexinho/bbb-scraper`) Actor

Scrape BBB business profiles, ratings (A+ to F), customer reviews, complaints, and decoded contact emails. Search by keyword + location or pass direct profile URLs. Filter by accreditation status or minimum rating. Covers 5.4M businesses across the US and Canada.

- **URL**: https://apify.com/zadexinho/bbb-scraper.md
- **Developed by:** [zadexinho](https://apify.com/zadexinho) (community)
- **Categories:** Lead generation, Automation, SEO tools
- **Stats:** 32 total users, 3 monthly users, 80.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 profile scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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 Scraper

Scrape business profiles, ratings, reviews, and complaints from the Better Business Bureau (bbb.org) — 5.4 million businesses across the US and Canada.

**What you get:**
- Business profiles with BBB letter rating (A+ to F), numeric score, and accreditation status
- Contact info: address, phone, decoded email, website
- Customer reviews with star ratings, text, and verification status
- Complaints with resolution history, business responses, and customer rebuttals
- Summary stats: review counts, average rating, star distribution, complaint breakdown

**How it works:**
- Search by keyword + location (e.g., "plumber" in "Dallas, TX")
- Or pass direct BBB profile URLs
- Filter by accreditation status or minimum rating
- ~7 seconds per profile with automatic Cloudflare bypass

### What data can you extract?

#### Business profiles

| Field | Type | Description |
|-------|------|-------------|
| `businessId` | string | BBB internal business ID |
| `name` | string | Business name |
| `url` | string | BBB profile URL |
| `rating` | string | BBB letter rating (A+ to F) |
| `ratingNumeric` | integer | Numeric score (97 for A+, down to 0 for F) |
| `isAccredited` | boolean | Whether BBB accredited |
| `accreditedSince` | string | Accreditation date (YYYY-MM-DD) |
| `address` | object | Full address: street, city, state, postalCode, country |
| `phone` | string | Business phone number |
| `email` | string | Business email (decoded from BBB obfuscation) |
| `website` | string | Business website URL |
| `categories` | string[] | Business categories (Plumber, Electrician, etc.) |
| `yearEstablished` | integer | Year the business was started |
| `bbbFileOpened` | string | Date BBB opened the file (YYYY-MM-DD) |
| `reviewSummary.totalReviews` | integer | Total customer review count |
| `reviewSummary.averageRating` | number | Average star rating (1-5) |
| `reviewSummary.starDistribution` | object | Breakdown by star rating |
| `complaintSummary.totalComplaints` | integer | Total complaint count |
| `complaintSummary.closedLast3Years` | integer | Complaints closed in last 3 years |
| `complaintSummary.closedLast12Months` | integer | Complaints closed in last 12 months |
| `complaintSummary.complaintTypes` | object | Breakdown by complaint type |
| `scrapedAt` | string | Scrape timestamp (ISO 8601) |

#### Customer reviews (when enabled)

| Field | Type | Description |
|-------|------|-------------|
| `reviews[].reviewId` | string | Unique review ID |
| `reviews[].rating` | integer | Star rating (1-5) |
| `reviews[].title` | string | Review headline |
| `reviews[].text` | string | Full review text |
| `reviews[].author` | string | Reviewer name |
| `reviews[].createdAt` | string | Review date |
| `reviews[].isVerified` | boolean | Whether review is verified |

#### Complaints (when enabled)

| Field | Type | Description |
|-------|------|-------------|
| `complaints[].complaintId` | string | Unique complaint ID |
| `complaints[].type` | string | Complaint type (e.g., Service Issues) |
| `complaints[].status` | string | Resolution status |
| `complaints[].dateFiled` | string | Date complaint was filed |
| `complaints[].dateClosed` | string | Date complaint was closed |
| `complaints[].text` | string | Complaint text |
| `complaints[].businessResponse` | string | Business response text |
| `complaints[].customerRebuttal` | string | Customer follow-up text |

### How to scrape BBB business profiles

1. Enter one or more BBB profile URLs in the **Business Profile URLs** field.
2. Or enter a **Search Keywords** (e.g., "plumber") and **Search Location** (e.g., "Dallas, TX") to discover businesses.
3. Optionally filter by **Accredited Only** or **Minimum BBB Rating**.
4. Enable **Include Customer Reviews** and **Include Complaints** to collect individual records.
5. Click **Start** and download results from the **Dataset** tab as JSON, CSV, or Excel.

### How much does it cost?

Pay-per-event pricing — you are charged per business profile scraped.

| Price per profile | Price per 1,000 profiles |
|------------------|------------------------|
| $0.001 | $1.00 |

**Example:** Scraping 100 business profiles costs approximately **$0.10**.

Reviews and complaints are included at no extra charge when enabled.

### Use cases

- **Lead generation** — Build lists of accredited businesses by category and location with contacts, ratings, and websites
- **Due diligence** — Research BBB ratings and complaint histories before partnerships or vendor selection
- **Competitive analysis** — Compare ratings and complaints across competitors in a metro area
- **Reputation monitoring** — Track complaint trends and resolution patterns over time
- **CRM enrichment** — Feed BBB data into your CRM for lead scoring and qualification
- **Cross-platform analysis** — Combine with Trustpilot, Google Reviews, and Sitejabber data
- **Compliance reporting** — Export BBB data for due diligence reports and audits

### Input

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `businessUrls` | string[] | `[]` | Direct BBB profile URLs to scrape |
| `searchQuery` | string | — | Search term (e.g., "plumber", "auto repair") |
| `searchLocation` | string | — | Location for search (e.g., "Dallas, TX") |
| `maxSearchResults` | integer | `20` | Max businesses to collect from search (1-500) |
| `includeReviews` | boolean | `true` | Extract individual customer reviews |
| `includeComplaints` | boolean | `true` | Extract individual complaints with resolution details |
| `maxReviewsPerBusiness` | integer | `50` | Max reviews per business (0 = all) |
| `maxComplaintsPerBusiness` | integer | `50` | Max complaints per business (0 = all) |
| `accreditedOnly` | boolean | `false` | Only scrape BBB-accredited businesses |
| `minRating` | string | — | Minimum BBB letter rating (A+ to F) |
| `requestDelay` | integer | `2000` | Delay between requests in ms (500-10000) |
| `proxy` | object | Residential US | Proxy configuration (residential required) |

#### Input examples

**Direct profile URL:**
```json
{
    "businessUrls": ["https://www.bbb.org/us/tx/dallas/profile/plumber/milestone-electric-ac-plumbing-0875-91344019"]
}
````

**Search by keyword and location:**

```json
{
    "searchQuery": "plumber",
    "searchLocation": "Dallas, TX",
    "maxSearchResults": 50
}
```

**Accredited businesses with minimum rating:**

```json
{
    "searchQuery": "roofing contractor",
    "searchLocation": "Denver, CO",
    "maxSearchResults": 100,
    "accreditedOnly": true,
    "minRating": "A"
}
```

**Quick search without reviews (faster):**

```json
{
    "searchQuery": "auto repair",
    "searchLocation": "Chicago, IL",
    "maxSearchResults": 30,
    "includeReviews": false,
    "includeComplaints": false
}
```

### Output example

```json
{
    "businessId": "22011175",
    "bbbId": "0011",
    "name": "Len The Plumber, Inc.",
    "url": "https://www.bbb.org/us/md/baltimore/profile/plumber/len-the-plumber-inc-0011-22011175",
    "rating": "A+",
    "ratingNumeric": 97,
    "isAccredited": true,
    "accreditedSince": "2008-06-05",
    "address": {
        "street": "3610 Commerce Dr",
        "city": "Halethorpe",
        "state": "MD",
        "postalCode": "21227",
        "country": "US"
    },
    "phone": "(410) 752-0136",
    "email": "BBBinquiries@themastertradesgroup.com",
    "website": "https://lentheplumber.com",
    "categories": [
        "Plumber",
        "Heating and Air Conditioning",
        "Air Conditioning Contractors",
        "Water Heater Repair"
    ],
    "yearEstablished": 1995,
    "bbbFileOpened": "2002-01-15",
    "reviewSummary": {
        "averageRating": 4.59,
        "totalReviews": 2167
    },
    "complaintSummary": {
        "totalComplaints": 171,
        "closedLast3Years": 171,
        "closedLast12Months": 68
    },
    "reviews": [
        {
            "reviewId": "r-1234567",
            "rating": 5,
            "title": "Excellent emergency service",
            "text": "Called at 10pm for a burst pipe. Technician arrived within 45 minutes and fixed it quickly. Fair pricing.",
            "author": "John M.",
            "createdAt": "2026-01-15",
            "isVerified": true
        }
    ],
    "complaints": [
        {
            "complaintId": "c-9876543",
            "type": "Service Issues",
            "status": "Answered",
            "dateFiled": "2025-11-20",
            "dateClosed": "2025-12-15",
            "text": "Technician quoted $200 for repair but final bill was $450 with undisclosed charges.",
            "businessResponse": "We have reached out to the customer directly to resolve this billing discrepancy."
        }
    ],
    "scrapedAt": "2026-02-18T17:18:03.532187+00:00"
}
```

### Tips

- BBB requires **residential US proxy** — the default config uses Apify's RESIDENTIAL group. Do not disable this.
- Disable `includeReviews` and `includeComplaints` for faster runs when you only need profile data and summaries.
- Use `accreditedOnly: true` for lead generation where trust signals matter.
- Use `minRating: "A"` to only get A+, A, and A- rated businesses.
- Increase `requestDelay` to `3000`+ for large runs (100+ profiles).
- BBB obfuscates emails in HTML — this scraper decodes them automatically.
- Each profile includes review and complaint **summaries** even when individual records are disabled.

### FAQ

#### How many businesses can I scrape?

Set `maxSearchResults` up to 500 per search. For more, run multiple searches with different locations. Direct URL mode has no limit.

#### Do I need a residential proxy?

Yes. BBB uses Cloudflare protection that blocks datacenter proxies. The default configuration uses Apify's RESIDENTIAL proxy group with US country, included in all Apify plans.

#### How fast is it?

\~7 seconds per profile. A search for 20 businesses completes in 2-3 minutes.

#### What if a business profile returns no data?

The scraper logs a warning and moves on. A circuit breaker stops the run after 5 consecutive failures to avoid wasting resources.

#### Can I combine this with other review scrapers?

Yes. Use BBB data alongside [Trustpilot Scraper](https://apify.com/zadexinho/trustpilot-scraper) and [Sitejabber Scraper](https://apify.com/zadexinho/sitejabber-scraper) for cross-platform reputation profiles.

#### How is the email decoded?

BBB obfuscates emails using a custom encoding scheme. This scraper reverses the obfuscation automatically — no post-processing needed.

#### What BBB ratings are available?

Letter grades: A+, A, A-, B+, B, B-, C+, C, C-, D+, D, D-, F. The `ratingNumeric` field provides a 0-97 numeric equivalent for sorting and filtering.

### Changelog

- **v0.3** — Pay-per-event pricing with spending limit support. Data completeness fixes (field names, website URL, phone parsing). Dead code cleanup.
- **v0.2** — README rewrite, pricing documentation, input schema improvements.
- **v0.1.15** — Speed optimization: 90s to 7s per profile. Email decoder. Cloudflare timing fixes.
- **v0.1** — Initial release. Search + profile extraction, Playwright, circuit breaker, review and complaint extraction.

# Actor input Schema

## `businessUrls` (type: `array`):

Direct BBB business profile URLs to scrape. Example: https://www.bbb.org/us/ca/los-angeles/profile/roofing-contractors/company-name-1234-56789

## `searchQuery` (type: `string`):

Keywords to search BBB (e.g., 'plumber', 'roofing contractor', 'auto repair'). Requires Location.

## `searchLocation` (type: `string`):

City and state for search (e.g., 'Dallas, TX', 'New York, NY'). Required when using Search Keywords.

## `maxSearchResults` (type: `integer`):

Maximum number of businesses to scrape from search results.

## `includeReviews` (type: `boolean`):

Scrape customer reviews for each business. Increases run time.

## `includeComplaints` (type: `boolean`):

Scrape formal BBB complaints with status and resolution details.

## `maxReviewsPerBusiness` (type: `integer`):

Maximum customer reviews to collect per business. 0 = all available.

## `maxComplaintsPerBusiness` (type: `integer`):

Maximum complaints to collect per business. 0 = all available.

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

Only scrape BBB-accredited businesses.

## `minRating` (type: `string`):

Only include businesses with this BBB letter rating or better.

## `proxy` (type: `object`):

Residential US proxy recommended for best results with Cloudflare.

## `requestDelay` (type: `integer`):

Minimum delay between page loads. Increase if experiencing blocks.

## Actor input object example

```json
{
  "maxSearchResults": 20,
  "includeReviews": true,
  "includeComplaints": true,
  "maxReviewsPerBusiness": 50,
  "maxComplaintsPerBusiness": 50,
  "accreditedOnly": false,
  "minRating": "",
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  },
  "requestDelay": 2000
}
```

# 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 = {
    "maxSearchResults": 20,
    "maxReviewsPerBusiness": 50,
    "maxComplaintsPerBusiness": 50,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("zadexinho/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxSearchResults": 20,
    "maxReviewsPerBusiness": 50,
    "maxComplaintsPerBusiness": 50,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("zadexinho/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 '{
  "maxSearchResults": 20,
  "maxReviewsPerBusiness": 50,
  "maxComplaintsPerBusiness": 50,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call zadexinho/bbb-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zadexinho/bbb-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Better Business Bureau Scraper [PPR]",
        "description": "Scrape BBB business profiles, ratings (A+ to F), customer reviews, complaints, and decoded contact emails. Search by keyword + location or pass direct profile URLs. Filter by accreditation status or minimum rating. Covers 5.4M businesses across the US and Canada.",
        "version": "0.4",
        "x-build-id": "VtuL70BYwxUOlGHRL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/zadexinho~bbb-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-zadexinho-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/zadexinho~bbb-scraper/runs": {
            "post": {
                "operationId": "runs-sync-zadexinho-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/zadexinho~bbb-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-zadexinho-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": {
                    "businessUrls": {
                        "title": "Business Profile URLs",
                        "type": "array",
                        "description": "Direct BBB business profile URLs to scrape. Example: https://www.bbb.org/us/ca/los-angeles/profile/roofing-contractors/company-name-1234-56789",
                        "items": {
                            "type": "string"
                        }
                    },
                    "searchQuery": {
                        "title": "Search Keywords",
                        "type": "string",
                        "description": "Keywords to search BBB (e.g., 'plumber', 'roofing contractor', 'auto repair'). Requires Location."
                    },
                    "searchLocation": {
                        "title": "Search Location",
                        "type": "string",
                        "description": "City and state for search (e.g., 'Dallas, TX', 'New York, NY'). Required when using Search Keywords."
                    },
                    "maxSearchResults": {
                        "title": "Max Search Results",
                        "minimum": 1,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Maximum number of businesses to scrape from search results.",
                        "default": 20
                    },
                    "includeReviews": {
                        "title": "Include Customer Reviews",
                        "type": "boolean",
                        "description": "Scrape customer reviews for each business. Increases run time.",
                        "default": true
                    },
                    "includeComplaints": {
                        "title": "Include Complaints",
                        "type": "boolean",
                        "description": "Scrape formal BBB complaints with status and resolution details.",
                        "default": true
                    },
                    "maxReviewsPerBusiness": {
                        "title": "Max Reviews Per Business",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum customer reviews to collect per business. 0 = all available.",
                        "default": 50
                    },
                    "maxComplaintsPerBusiness": {
                        "title": "Max Complaints Per Business",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum complaints to collect per business. 0 = all available.",
                        "default": 50
                    },
                    "accreditedOnly": {
                        "title": "Accredited Only",
                        "type": "boolean",
                        "description": "Only scrape BBB-accredited businesses.",
                        "default": false
                    },
                    "minRating": {
                        "title": "Minimum BBB Rating",
                        "enum": [
                            "",
                            "A+",
                            "A",
                            "A-",
                            "B+",
                            "B",
                            "B-",
                            "C+",
                            "C",
                            "C-",
                            "D+",
                            "D",
                            "D-",
                            "F"
                        ],
                        "type": "string",
                        "description": "Only include businesses with this BBB letter rating or better.",
                        "default": ""
                    },
                    "proxy": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Residential US proxy recommended for best results with Cloudflare.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "US"
                        }
                    },
                    "requestDelay": {
                        "title": "Request Delay (ms)",
                        "minimum": 500,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Minimum delay between page loads. Increase if experiencing blocks.",
                        "default": 2000
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
