DealerRater for Developers

Dealer Entity

The dealer entity contains information about a single dealer in the DealerRater system, including basic metadata (name, address, etc) and information about overall ratings (by category, by visit reason, etc).

Sample Dealer XML

Dealer Attributes

AttributeTypeDescription
Id int The dealers's primary key. Used to uniquely identify a dealer in the system.
Name string The name of the dealer.
Address string The main address for the dealer.
City string The city the dealer resides in.
State string The state the dealer resides in.
PostalCode string The postal code for the dealer.
ReviewPageUrl URI Fully qualified URI that can be used to access the dealer's review page.
Country string The country the dealer resides in.
SalesPhone string The primary phone number for the sales department.
ServicePhone string The primary phone number for the service department.
PartsPhone string The primary phone number for the parts department.
WebAddress string The dealership's website.
Certified boolean True if the dealership is certified with DealerRater.
BasicListing boolean True if the dealership is a BasicListing dealership.
Latitude double Geo-positioning coordinates for the dealer.
Longitude double Geo-positioning coordinates for the dealer.
AboutUs string A brief biography about the dealer.
ReviewSummary/TotalLifetimeReviews1 int The total number of lifetime reviews the dealer has received.
ReviewSummary/TotalReviews1 int DEPRECATED. This value is no longer being computed nor provided and is now hardcoded to zero.
ReviewSummary/TotalNewSalesReviews1 int DEPRECATED. This value is no longer being computed nor provided and is now hardcoded to zero.
ReviewSummary/TotalUsedSalesReviews1 int DEPRECATED. This value is no longer being computed nor provided and is now hardcoded to zero.
ReviewSummary/TotalServiceReviews1 int The total number of service reviews the dealer has received in the last 24 month period.
ReviewSummary/AverageRating2 double The overall average rating of the dealer for the last 24 month period.
ReviewSummary/AverageServiceRating2 double The average rating for service reviews over the last 24 month period.
ReviewSummary/AverageNewSalesRating2 double DEPRECATED. This value is no longer being computed nor provided and is now hardcoded to zero.
ReviewSummary/AverageUsedSalesRating2 double DEPRECATED. This value is no longer being computed nor provided and is now hardcoded to zero.
ReviewSummary/AverageCustomerServiceRating2 double The average customer service rating over the last 24 month period.
ReviewSummary/AverageFriendlinessRating2 double The average friendliness rating over the last 24 month period.
ReviewSummary/AverageQualityOfWorkRating2 double The average quality of work rating over the last 24 month period.
ReviewSummary/AveragePriceRating2 double The average price rating over the last 24 month period.
ReviewSummary/AverageOverallExperienceRating2 double The average overall experience rating over the last 24 month period.
1: A value of zero or an empty element indicates that this dealer has no reviews in that category.
2: A value of zero or empty means that the dealer has no data for this attribute over the last 24 months. In that case, the data should be shown as N/A (not applicable). As an example, if a dealer receives 10 reviews over the last 24 months, but each review only rates the dealer on Overall Experience, then the Price, Quality of Work, Friendliness and Customer Service ratings will all be N/A.