# Carwow Model Review API Documentation

Retrieve the Carwow expert review of a new car model: wowscore rating out of 10, the full review text as plain text, pros and cons, price range in GBP, body type, fuel type, seats, boot space, fuel economy range, engine size range and review videos. An unknown model answers 404 and is not billed.

- **Documentation:** [https://scrappa.co/docs/carwow-api/carwow_model](https://scrappa.co/docs/carwow-api/carwow_model)
- **API group:** Carwow API
- **Endpoint:** `GET https://scrappa.co/api/carwow/model`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `brand` | string | Yes | Brand slug, lowercase letters, numbers and hyphens. Example: bmw. |
| `model` | string | Yes | Model slug. Example: 4-series. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/carwow/model?brand=bmw&model=4-series"
```

## Example response

```json
{
    "success": true,
    "data": {
        "title": "BMW 4 Series",
        "brand": "BMW",
        "model": "4 Series",
        "url": "https://www.carwow.co.uk/bmw/4-series",
        "summary": "The BMW 4 Series is a sleek premium coupe with great tech and strong engines. It feels firm at low speeds, though, and not everybody will be convinced by those front-end looks",
        "image_url": "https://images.prismic.io/carwow/a28bc8fe-53aa-412c-a34c-cace8d88d826_BMW-4-series-lead-1-scaled.jpg",
        "rating": 9,
        "best_rating": 10,
        "price_from": 46180,
        "price_to": 67860,
        "currency": "GBP",
        "body_type": "Coupes",
        "fuel_type": "Petrol",
        "seats": 4,
        "boot_litres": 440,
        "mpg_min": 39.8,
        "mpg_max": 44.8,
        "engine_litres_min": 2,
        "engine_litres_max": 3,
        "review": {
            "text": "How much is the BMW 4 Series?\n\nThe executive coupe arena is a popular one with a number of useful models vying for business. Aside from the 4 Series, two of the...",
            "published_at": "2023-07-06T15:07:56Z",
            "updated_at": "2025-01-17T13:02:15Z",
            "pros": [
                "Superb engine choices",
                "Great fun to drive on a country road",
                "Fantastic interior quality"
            ],
            "cons": [
                "Rear head room is tight for adults",
                "Some options only come in pricey packs",
                "That grille will turn some people off"
            ]
        },
        "videos": [
            {
                "title": "In-depth video review",
                "description": "Is the BMW 4 Series a good car? Watch Carwow\u2019s overview video to see a full in-depth review of the BMW 4 Series and hear Mat Watson\u2019s verdict on the car.",
                "url": "https://www.youtube.com/watch?v=eppLrUYDYTc",
                "thumbnail_url": "https://images.prismic.io/carwow/eb48c73d-85cd-458a-b659-859ab03020cf_bmw-4-series-review-thumbnail-nb-1.jpg",
                "uploaded_at": "2020-10-21T08:15:47Z"
            }
        ]
    },
    "meta": {
        "endpoint_family": "model",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested Carwow resource does not exist. This response is not billable. |
| 503 | Invalid Source Response | The upstream answered with a page that no longer matches the documented contract. This response is not billable. |
| 503 | Service Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)