# Edmunds Editorial Review API Documentation

Get the Edmunds editorial review of one model year: overall rating, verdict, summary, what you need to know, trim recommendation, competitors, pros, cons, topic ratings with text and detail grades such as Very Good. All text is plain text. Older model years return the shorter legacy review with sections instead of scores. A year or submodel that Edmunds has not reviewed returns a not-billable 404.

- **Documentation:** [https://scrappa.co/docs/edmunds-api/edmunds_reviews_editorial](https://scrappa.co/docs/edmunds-api/edmunds_reviews_editorial)
- **API group:** Edmunds API
- **Endpoint:** `GET https://scrappa.co/api/edmunds/reviews/editorial`

## 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 |
| --- | --- | --- | --- |
| `make` | string | Yes | Make slug in lowercase. Example: toyota. |
| `model` | string | Yes | Model slug in lowercase. Example: camry. |
| `year` | integer | Yes | Model year. Example: 2025. |
| `submodel` | string | Yes | Submodel slug from the model years endpoint. Example: sedan. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/edmunds/reviews/editorial?make=toyota&model=camry&year=2025&submodel=sedan"
```

## Example response

```json
{
    "success": true,
    "data": {
        "make": "toyota",
        "model": "camry",
        "year": 2025,
        "submodel": "sedan",
        "review": {
            "rating": 8.4,
            "verdict": "The redesigned 2025 Toyota Camry now has an all-hybrid lineup and it makes perfect sense for this moment. Besides great mpg, the Camry has a roomy and comfortab...",
            "subtitle": "The 9th-generation Camry is all-hybrid, high-tech",
            "summary": "Whoever said that the sedan is dead, Toyota would like a word with you because the company has given the 2025 Camry a complete redesign that transforms the mids...",
            "need_to_know": "A source of confusion for 2025 might be the discontinuation of the Camry Hybrid \u2014 at least as a model name. But in actuality, Toyota has made every Camry a hybr...",
            "recommendation": "We think the midgrade XLE model makes sense for most consumers. It comes with the larger 12.3-inch infotainment screen and some nice-to-have creature comforts,...",
            "competitors": "The Toyota Camry's chief rival through the decades is the Honda Accord. The Accord was redesigned for the 2023 model year, incorporating smoothed-out styling wi...",
            "pros": [
                "High fuel economy",
                "Quiet and roomy interior",
                "Easy to drive and operate"
            ],
            "cons": [
                "Engine sounds coarse during hard acceleration",
                "Front seat comfort is lacking"
            ],
            "author_url": "https://www.edmunds.com/editorial/authors/brian-wong",
            "published_on": "2024-05-01",
            "updated_on": "2025-10-17",
            "tested_on": "2024-04-15",
            "url": "https://www.edmunds.com/toyota/camry/2025/review/",
            "ratings": [
                {
                    "topic": "driving",
                    "score": 8.6,
                    "text": "We tested the Camry XSE with front-wheel drive. Acceleration is smooth and easy, and there's enough power on tap when you need it for passing, merging and other..."
                },
                {
                    "topic": "comfort",
                    "score": 8,
                    "text": "The Camry's front seats feel a bit too firm, but they are great for back support on long drives. They're generally very comfortable once you settle in on a long..."
                },
                {
                    "topic": "value",
                    "score": 8.2,
                    "text": "Toyota's decision to make every Camry a hybrid means there are plenty of trim levels to choose from if you're seeking a hybrid. That's a different approach than..."
                }
            ],
            "details": [
                {
                    "topic": "driving",
                    "aspect": "steering",
                    "grade": "Very Good",
                    "text": "Might be an unpopular opinion but I prefer the steering in the Camry to the Accord. There is a huge difference in the weighting between Normal and Sport mode, w..."
                },
                {
                    "topic": "storage",
                    "aspect": "space",
                    "grade": "Good",
                    "text": "15.1 cubic feet of space is less than both the Hyundai Sonata and the Honda Accord. Still, it should be plenty of space to accomodate a few large suitcases or a..."
                },
                {
                    "topic": "value",
                    "aspect": "warranty",
                    "grade": "Good"
                }
            ]
        }
    },
    "meta": {
        "endpoint_family": "editorial_review",
        "billable": true
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | A required query parameter is missing or invalid. This response is not billable. |
| 404 | Resource Not Found | The requested Edmunds resource does not exist. This response is not billable. |
| 503 | Invalid Source Response | The upstream answered with a shape 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)