# CarBuzz Scraper (`codingfrontend/carbuzz-scraper`) Actor

Extract public CarBuzz vehicle reviews, ratings, pricing, specifications, pros, cons, and trim data; independent and not endorsed by CarBuzz.

- **URL**: https://apify.com/codingfrontend/carbuzz-scraper.md
- **Developed by:** [Coding Frontned](https://apify.com/codingfrontend) (community)
- **Categories:** Other, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## CarBuzz Scraper

Extract structured vehicle-review data from public CarBuzz make/model/year pages. Supply one or more CarBuzz vehicle URLs and receive normalized records with pricing, BuzzScore ratings, rating breakdowns, engines, drivetrains, transmissions, horsepower, torque, fuel economy, pros, cons, base specifications, and published trim cards.

This Actor is an independent community tool. It is not affiliated with, endorsed by, or operated by CarBuzz or Valnet. Review text, ratings, images, and vehicle specifications remain attributable to their source. Follow applicable terms and use the data responsibly.

### Input

`startUrls` accepts public HTTPS URLs under `carbuzz.com/cars/`, for example:

```json
{
  "startUrls": [
    "https://carbuzz.com/cars/toyota/camry/2025/"
  ],
  "maxPages": 1,
  "maxTrimsPerVehicle": 20
}
```

The Actor normalizes and deduplicates URLs before fetching. `maxPages` limits unique vehicle pages. `maxTrimsPerVehicle` caps trim cards attached to a result. `maxConcurrency` is intentionally limited to three, while `requestDelayMillis` enforces pacing. `maxRetries`, `maxPageMbytes`, and `maxRunMillis` provide bounded failure and resource controls. Apify Proxy is optional; direct public access is used by default.

### Output

Each dataset row represents one canonical vehicle-year review and includes:

- stable hashed `recordId`, vehicle name, model year, make, model, and body type;
- source `summary` and primary image URL;
- engine, drivetrain, transmission, horsepower, torque, and fuel economy when published;
- numeric starting price and currency;
- numeric overall BuzzScore and named rating components;
- ordered pros and cons from CarBuzz structured review data;
- `baseSpecifications` with published base-trim labels and values;
- `trims`, where each trim contains its name and the specifications displayed on its card;
- review author and publication date when available;
- canonical source URL and scrape timestamp.

Unavailable optional keys are omitted. Numeric price and rating fields remain JSON numbers; specification strings retain source units and qualifiers.

### Extraction and data quality

CarBuzz exposes rich schema.org structured review data in its public HTML. The Actor uses that structured data for vehicle identity, offer price, rating, rating breakdown, author, publication date, pros, and cons. It supplements this with public base-trim and trim-card specification pairs from the rendered HTML.

Every page must return valid HTML and a real vehicle `Review` object. The Actor rejects challenge pages, oversized responses, missing required identity fields, and duplicate canonical URLs. It uses realistic consistent headers, one anonymous public request per page, responsible pacing, bounded exponential retries, and a deadline below five minutes. It never creates mock vehicles, placeholder values, or hardcoded success records.

### Limitations

Specifications and ratings reflect CarBuzz editorial content at scrape time and may differ by market, drivetrain, trim, options, or later correction. A page may not publish every optional field. Trim cards shown in an article can be a curated subset rather than the entire manufacturer configuration catalog. Pricing generally excludes taxes, registration, destination fees, and optional equipment unless the source says otherwise.

Use manufacturer documentation for purchase-critical configuration details and safety recalls. CarBuzz reviews are editorial opinions, not mechanical inspections or guarantees.

# Actor input Schema

## `startUrls` (type: `array`):

Public CarBuzz make/model/year URLs under carbuzz.com/cars/.

## `maxPages` (type: `integer`):

Hard cap on unique vehicle pages processed.

## `maxTrimsPerVehicle` (type: `integer`):

Maximum trim cards and their published specs attached to one vehicle record.

## `maxConcurrency` (type: `integer`):

Small responsible concurrency cap for public review pages.

## `requestDelayMillis` (type: `integer`):

Minimum pacing delay for CarBuzz requests.

## `maxRetries` (type: `integer`):

Bounded attempts with exponential backoff for transient failures.

## `maxPageMbytes` (type: `integer`):

Reject unexpectedly large HTML responses.

## `maxRunMillis` (type: `integer`):

Actor-side deadline capped below five minutes.

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

Optional Apify Proxy. Direct public access is used by default.

## Actor input object example

```json
{
  "startUrls": [
    "https://carbuzz.com/cars/toyota/camry/2025/"
  ],
  "maxPages": 10,
  "maxTrimsPerVehicle": 20,
  "maxConcurrency": 1,
  "requestDelayMillis": 750,
  "maxRetries": 3,
  "maxPageMbytes": 5,
  "maxRunMillis": 240000,
  "proxyConfiguration": {
    "useApifyProxy": 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("codingfrontend/carbuzz-scraper").call(input);

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

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

```

## Python example

```python
from apify_client import ApifyClient

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

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("codingfrontend/carbuzz-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 '{}' |
apify call codingfrontend/carbuzz-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/zxVI5674M5EyZY1Ua/builds/MfWKAA1xLvfgZWbut/openapi.json