• Overview
• Authentication
• Pagination


• APIs
• Reviews

Overview

The Dealerrater API has been developed to help dealers and authorized partners access a variety of content sourced on the DealerRater website, as well as allowing dealers and their agents to access and manage their reviews and dealer information.

The API is accessed via a single website domain, https://api.dealerrater.com. SSL is required for access to the API.

Authentication

All requests to the DealerRater API must be accompanied by an accessToken querystring parameter. Access tokens may be requested from DealerRater Customer Support or can be generated in the Dealer Panel for DealerRater Certified Dealers. Access tokens are associated to individual dealers and partners and they may not be shared.

NOTE: Prior to being able to use an accessToken, the DealerRater API EULA must be read and accepted.

Pagination

Requests can contain optional pagination hints in the querystring in the form of https://api.dealerrater.com/reviews/17668?accessToken=12345&limit=4&offset=3, where:

• limit: The total number of elements to return
• offset: The offset to start returning results from

Reviews API

You can access review details for a DealerRater dealer by requesting https://api.dealerrater.com/reviews/DEALER_ID?accessToken=YOUR_ACCESS_TOKEN, where:

• DEALER_ID: The numerical ID of the dealer
• ACCESS_TOKEN: The unique access token assigned by DealerRater

Example: https://api.dealerrater.com/reviews/17668?accessToken=12345

Results are returned in JSON format, with the following attributes:

    {
        "dealerId":"17668",
        "ratingUrl":"http://www.dealerrater.com/17668",
        "reviewsUrl":"http://www.dealerrater.com/dealer/Example-Dealer-review-17668/",
        "name":"Example Dealer",
        "reviewCount":1,
        "ratings":{
            "averageRating":4.8,
            "customerService":4.8,
            "quality":4.8,
            "friendliness":4.9,
            "overallExperience":4.8,
            "price":4.5
        },
        "reviews":[
            {
                "id": "12345",
                "user":{
                    "username":"Ricco1",
                    "location":{
                        "city":"Foxboro",
                        "state":"MA"
                    }
                },
                "dateWritten":"04/28/2011 04:22:48-04:00",
                "employees":"Mr Dan MacDonald",
                "visitReason":"Sales (New)",
                "title":"I have been going to this dealer for several years now...",
                "comments":"I have been going to this dealer for several years now.\r\nI always ask and deal with Dan MacDonald.\r\nhe's very professional, courteous and knowledgeable.\r\n\r\nDan is always one of the busiest people at the Dealership but he finds time to always be available which i really like and that true is service.\r\nI am not the easiest person to deal with but Dan always seems to be keep my heat to a minimum and do a great job.\r\nhe's calm cool and collected and i highly recommend him to all BMW owners.\r\n\r\nOn a side Note: the lady who meet and greats "pat" she is wonderfulllll... great to see her everytime.\r\n\r",
                "recommendDealer":"Yes",
                "ratings":{
                    "customerService":5,
                    "quality":5,
                    "friendliness":5,
                    "overallExperience":5,
                    "price":3
                },
                "responses":[
                    {
                        "dateEntered":"04/30/2011 08:23:54-04:00",
                        "responseText":"Dealer's public response."
                        "user":{
                            "username":"Example Dealer"                            
                        }
                    }
                ]
            }
        ]
    }