Vehicle Ratings and Reviews Repository

The Vehicle Ratings and Reviews are submited by visitors to Edmunds.com. In order to get that content, you need to provide the make, model and year values of the vehicle in question.

Go to:

• URL
• Response Format
• Sample Request
• Special Requirements
• Parameters

Please read the API Documentation page for information that applies to all our APIs. 

URL

http://api.edmunds.com/{version}/api/crrrepository/getcrrformakemodelyear?

Response Formattop

{
    "reviews": [{
        reviewObject,
        reviewObject,
        ...
    ]
}

A reviewObject will look like this:

{
    "consumerName": [the name of the consumer][string],
    "styleId": [the style ID of the vehicle related to this review][long],
    "title": [the title of the review][string],
    "likes": [how many people agree with this review][integer],
    "totalRating": [the aggregate rating for this review][float],
    "favorites": [visitor's writeup on his/her favorite part about the vehicle][string],
    "suggestions": [visitor's writeup on his/her suggestions for the vehicle][string],
    "date": [the date the review was created][date],
    "ratings": {
        "fuelEconomy": [float],
        "buildQuality": [float],
        "comfort": [float],
        "performance": [float],
        "realiability": [float],
        "exteriorDesign": [float],
        "funToDrive": [float],
        "interiorDesign": [float]
    },
    "review": [the visitor's review][string]
}

Sample Requesttop

http://api.edmunds.com/{version}/api/crrrepository/getcrrformakemodelyear?make=honda&model=accord&year=2001&api_key=xxxxxxxxxx&fmt=json

Sample Response

{
    "reviews": [{
        "consumerName": "mc1223",
        "styleId": 100001207,
        "title": "An awesom car!",
        "likes": 0,
        "totalRating": 5.0,
        "favorites": "I love it all!!",
        "suggestions": "More power in the 4cyl models.",
        "date": {},
        "ratings": {
            "fuelEconomy": 5.0,
            "buildQuality": 5.0,
            "comfort": 5.0,
            "performance": 5.0,
            "realiability": 5.0,
            "exteriorDesign": 5.0,
            "funToDrive": 5.0,
            "interiorDesign": 5.0
        },
        "review": "I used to drive a Jetta which I loved, \r\nbut decided to go with a Honda after my \r\nfriend put 179k on her \u002789 Accord, \r\nwhich ran incredible. I have a \u002702 \r\nAccord EX Coupe (only 4cyl), which \r\ncould be faster, but thats what \r\nperformance intakes and exhaust systems \r\nare for. Its extremely comfortable and \r\nrides very smooth. Gas mileage is good, \r\nwhich helps me with the amount of miles \r\nI put on it. The car is good looking, \r\nwhich will turn heads once I finish \r\nwith the work I am doing to it. Bottom \r\nline...this car will run forever if you \r\ntake car of it and is one of the most \r\nreliable cars out there. Resale value \r\nis also excellent."
       }, 
       {
        "consumerName": "boisedogmom",
        "styleId": 100001207,
        "title": "Love my Honda!",
        "likes": 0,
        "totalRating": 4.8,
        "favorites": "The acceleration is excellent with the \r\nV-6 engine.  Very happy with the ride \r\nand the solid feel of the vehicle.  \r\nLike having both CD and cassette \r\noptions in the dash.",
        "suggestions": "Definitely heated seats!  The Canadian \r\nmodel did have them, and that would be \r\na huge plus.  Driver\u0027s seat needs to \r\nmove further to allow better access to \r\nback seat.",
        "date": {},
        "ratings": {
            "fuelEconomy": 4.0,
            "buildQuality": 5.0,
            "comfort": 4.0,
            "performance": 5.0,
            "realiability": 5.0,
            "exteriorDesign": 5.0,
            "funToDrive": 5.0,
            "interiorDesign": 5.0
        },
        ...
        ...
        ...
    ]
}

Special Requirementstop

Edmunds.com’s Visitor Vehicle Ratings and Reviews are provided to Edmunds.com by its visitors, and are the proprietary materials of Edmunds.com, Inc. by virtue of Edmunds’ agreements with its visitors.

Accordingly, we have special requirements for the display of Visitor Vehicle Ratings and Reviews. 

• The display of Visitor Vehicle Ratings and Reviews (or either of them) must clearly and prominently state that the Ratings and Reviews are from visitors to www.edmunds.com, and may not state or imply that they constitute the opinion of Edmunds.com.  For example:

Visitor reviews of this vehicle posted on Edmunds.com:

OR:

Edmunds.com visitor vehicle reviews:

OR:

Average vehicle rating from visitors to Edmunds.com:

OR:

Edmunds.com average visitor rating for this vehicle:

• If not all of the Visitor Vehicle Reviews for a particular vehicle are displayed, you must make clear that you are displaying only selected Visitor Vehicle Reviews.  For example

Selected visitor reviews of this vehicle posted on Edmunds.com:

OR:

Selected Edmunds.com visitor vehicle reviews:

• No Visitor Vehicle Review that is displayed may be edited or abridged.

• Each Visitor Vehicle Review must include the username of the visitor who submitted it and the published date (as it is returned by the API).

• You must be include the following legal notice:

Edmunds.com Visitor Vehicle Ratings and Reviews are the property of Edmunds.com, and may not be reproduced or distributed without the consent of Edmunds.com.  Edmunds^® is a trademark of Edmunds.com, Inc. Edmunds.com, Inc. is not affiliated with this website or app. 

Parameterstop