# Cars.com Scraper

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v1/website/rendering` |
| **Base URL** | `https://api.browsersolver.com` |
| **Credit Cost** | 2 credits per call |
| **Documentation** | https://www.browsersolver.com/library/website-rendering-cars-com-scraper |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.browsersolver.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Render Cars.com listing detail pages and return hydrated HTML for price, location, and attribute extraction.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.browsersolver.com/register

## Example Request

```bash
curl --location --request GET 'https://api.browsersolver.com/v1/website/rendering' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Cars.com auto HTML

```json
<!DOCTYPE html><html lang="en"><head><meta charset="utf-8"/><title>Vehicle | Cars.com</title><meta name="x-bs-slug" content="cars-com"/><meta name="x-bs-source" content="browsersolver-selectors"/></head><body data-page="listing" data-brand="cars.com" data-surface="auto" data-seed="40421" data-wait-hint="article.listing"><main><article class="listing" data-id="v80421"><h1>2021 Harbor Compact</h1><div class="price">€18500</div><ul class="specs"><li>61000 km</li><li>Manual</li><li>Diesel</li></ul><div class="dealer">Harbor Motors | Lyon</div></article><article class="listing" data-id="v80422"><h2>Cedar Estate</h2><div class="price">€20400</div></article><script id="__NEXT_DATA__" type="application/json">{"props":{"pageProps":{"slug":"cars-com"}}}</script></main><section class="x-bs-enrich" data-slug="cars-com"><p>Cars.com HTML fixtures for BrowserSolver rendering examples.</p></section></body></html>
```

## Documentation

## Overview

Send a fully-qualified Cars.com URL to **Cars.com Scraper** and receive the post-render HTML document.
**Pricing:** 2 credits per successful call via [Website Rendering](/v1/website/rendering).

## Quickstart
```
GET https://api.browsersolver.com/v1/website/rendering?query=https://www.cars.com/shopping/results/?stock_type=used&makes%5B%5D=toyota&zip=94107
```

## Workflows
- Track vehicle price and mileage
- Extract trim and option lists
- Archive dealer contact blocks

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Absolute Cars.com URL |
| `wait_in_seconds` | number | no | Extra pause after load (0-30) |
| `wait_for` | string | no | CSS/XPath selector that must appear |
| `block_ads` | boolean | no | Drop ad traffic during render |
| `timeout` | number | no | Max render seconds (default 30) |

## Response
HTML after JavaScript execution.

## Use cases
- Track vehicle price and mileage
- Extract trim and option lists
- Archive dealer contact blocks

## Notes
- Prefer [Website Crawler](/v1/website/crawler) if markup arrives without JS.
- Use [Website WebUnlocker](/v1/website/webunlocker) only on approved, heavily protected hosts.