The Dealer API V1

The Dealer API provides information about automotive dealerships associated with a given criteria like zipcode, Make or Style ID amongst other things.

Go to:

• URL
• Response Format
• Sample Request
• Parameters

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

URL

http://api.edmunds.com/{version}/api/dealer

Response Formattop

All method responses are JSON objects that have a root property called, dealerHolder. The value of dealerHolder is an array of Dealer objects:

{
    "dealerHolder": [
        dealer_object_1,
        dealer_object_2,
        dealer_object_3, 
        ....
        ....
     ]
}

Each Style object is a JSON object of the following format:

{
    "id": [integer],
    "address": [addressObject]
    "name": [string],
    "logicalName": [string],
    "type": [string],
    "make": [string],
    "operations": [dateObject],
    "contactinfo": [contactObject],
    "active": [boolean]
}

The properties of the Dealer object are:

• id: The dealer ID
• address: The address of the dealer
• name: The name of the dealer
• logicalName: The dealer's nice name, or URL-friendly name
• type: The type of dealer
• make: The vehicle make this dealer is known to handle
• operations: The working hours by day
• categories: The model various types
• contactinfo: The dealer's contact info
• active: Is this dealer active?

Sample Requesttop

http://api.edmunds.com/{version}/api/dealer?zipcode=90404&api_key=xxxxxxxxxx&fmt=json

Sample Response

{
    "dealerHolder": [
        {
            "id": "26729",
            "address": {
                "street": "2440 Santa Monica Blvd",
                "apartment": "",
                "city": "Santa Monica",
                "stateCode": "CA",
                "stateName": "California",
                "county": "Los Angeles",
                "country": "USA",
                "zipcode": "90404",
                "latitude": 34.032051,
                "longitude": -118.475512
            },
            "name": "Volkswagen of Santa Monica",
            "logicalName": "VolkswagenofSantaMonica",
            "syndicationPartner": "Edmunds",
            "type": "ROOFTOP",
            "make": "Volkswagen",
            "operations": {
                "Wednesday": "9:00 AM-9:00 PM",
                "Tuesday": "9:00 AM-9:00 PM",
                "Thursday": "9:00 AM-9:00 PM",
                "Saturday": "9:00 AM-7:00 PM",
                "Friday": "9:00 AM-9:00 PM",
                "Monday": "9:00 AM-9:00 PM",
                "Sunday": "10:00 AM-6:00 PM"
            },
            "contactinfo": {
                "dealer_website": "http://www.volkswagensantamonica.com/",
                "email_address": "",
                "phone_areacode": "888",
                "phone_postfix": "0773",
                "phone_prefix": "459",
                "phone": "8884590773"
            },
            "publishDate": "2011-08-01",
            "active": true,
            "ratings": {
                "SALES_DEPTH_OF_VEHICLE_KNOWLEDGE": "0.0",
                "SALES_OVERALL_RATING": "3.4",
                "SALES_RESPONSIVENESS_TO_INQUIRIES": "0.0",
                "SALES_DEALER_RESPONSE_TIME": "0.0",
                "SALES_ONLINE_SALES_INTERACTION": "0.0",
                "SALES_DEALER_TOTAL_REVIEW_COUNT": "3.0",
                "SALES_PROFESSIONALISM": "0.0",
                "SALES_VEHICLE_PURCHASE": "0.0",
                "SALES_SALES_PRESSURE": "0.0",
                "SERVICE_OVERALL_RATING": "0.0",
                "SALES_VALUE_OF_TRADE_IN": "0.0",
                "SALES_ABILITY_TO_NEGOTIATE_A_DEAL": "0.0",
                "SALES_RECOMMENDED_REVIEW_COUNT": "1.0",
                "SALES_NOT_RECOMMENDED_REVIEW_COUNT": "1.0",
                "SERVICE_DEALER_TOTAL_REVIEW_COUNT": "1.0",
                "SALES_EXPEDIENCY_OF_SALES_PROCESS": "0.0",
                "SALES_EXPLANATION_OF_TERMS": "0.0",
                "SERVICE_RECOMMENDED_REVIEW_COUNT": "0.0",
                "SALES_READINESS_OF_VEHICLE_AT_DELIVERY": "0.0",
                "SALES_ACCESSORIES": "0.0",
                "SALES_INTERNET_SALES_PERSONNEL": "0.0",
                "SALES_DEALER_ATTENTIVENESS": "0.0",
                "SALES_ACCURACY_OF_INFORMATION_PROVIDED": "0.0",
                "SALES_TRANSPARENCY_OF_PROCESS": "0.0",
                "SALES_DEALER_REVIEW_COUNT": "2.0",
                "SALES_VEHICLE_DEAL": "0.0",
                "SERVICE_NOT_RECOMMENDED_REVIEW_COUNT": "0.0",
                "SALES_COMPETITIVENESS_OF_OFFERING": "0.0",
                "SERVICE_DEALER_REVIEW_COUNT": "0.0",
                "SALES_EXTENDED_SERVICES": "0.0",
                "SALES_DEALER_FINANCE": "0.0"
            }
        },
        ...
        ...
        ...
    ]
}

Parameterstop