API: 
Consumer Intent API
API Class: 
Consumer Intent API
Description: 

This method retrieves vehicle SRP and VDP view counts in a given set of Zip Codes.

URL

Note: Ensure all testing is done in development environment prior to moving to production.

Environment URL
development https://api-st.cars.com/ConsumerIntent/1.0/rest/reports/viewCounts
production https://api.cars.com/ConsumerIntent/1.0/rest/reports/viewCounts

 

Request

Request Example

https://api.cars.com/ConsumerIntent/1.0/rest/reports/viewCounts? make=Honda&model=Accord&vehicleYear=2015&zipCode=19428 &startDate=05/15/2016&endDate=06/10/2016&apikey=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Request Parameters
Request Parameter Type Example value Description Required
make String Acura Vehicle Make yes
model String MDX Vehicle Model yes
vehicleYear Integer 2014 Vehicle Year yes
zipCode String 12345,99999 Comma delimited list of Zip Codes. Up to 10 zip codes can be entered yes
startDate Date 05/15/2016 Start Date of date range. Must be within 60 days of yesterday's date. yes
endDate Date 07/15/2016 End Date of data range. Must be after Start Date. yes
apikey String xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx API Key given by Cars.com yes

 

 

Response

Response Data Formats
Response type Header value
xml Accept: application/xml
json Accept: application/json
ConsumerActivityResults
Element Type Description
consumerActivity ConsumerActivity See ConsumerActivity element description below
ConsumerActivity
Element Type Description
summaryDate Date Summary Date
vehicleMake String Vehicle Make
vehicleModel String Vehicle Model
vehicleYear String Vehicle Year
zipCode String Zip Code
totalSRPCount Int Total SRP Count
totalVDPCount Int Total VDP Count
Response XML example
<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<consumerActivityResults>
    <consumerActivity>
        <summaryDate>2016-05-28 00:00:00</summaryDate>
        <vehicleMake>Honda</vehicleMake>
        <vehicleModel>Accord</vehicleModel>
        <vehicleYear>2015</vehicleYear>
        <zipCode>19428</zipCode>
        <totalSRPCount>1683</totalSRPCount>
        <totalVDPCount>4</totalVDPCount>
    </consumerActivity>
    <consumerActivity>
        <summaryDate>2016-05-29 00:00:00</summaryDate>
        <vehicleMake>Honda</vehicleMake>
        <vehicleModel>Accord</vehicleModel>
        <vehicleYear>2015</vehicleYear>
        <zipCode>19428</zipCode>
        <totalSRPCount>2194</totalSRPCount>
        <totalVDPCount>3</totalVDPCount>
    </consumerActivity>
    <consumerActivity>
        <summaryDate>2016-05-30 00:00:00</summaryDate>
        <vehicleMake>Honda</vehicleMake>
        <vehicleModel>Accord</vehicleModel>
        <vehicleYear>2015</vehicleYear>
        <zipCode>19428</zipCode>
        <totalSRPCount>2594</totalSRPCount>
        <totalVDPCount>8</totalVDPCount>
    </consumerActivity>
    <consumerActivity>
        <summaryDate>2016-05-31 00:00:00</summaryDate>
        <vehicleMake>Honda</vehicleMake>
        <vehicleModel>Accord</vehicleModel>
        <vehicleYear>2015</vehicleYear>
        <zipCode>19428</zipCode>
        <totalSRPCount>2439</totalSRPCount>
        <totalVDPCount>5</totalVDPCount>
    </consumerActivity>
    <consumerActivity>
        <summaryDate>2016-06-01 00:00:00</summaryDate>
        <vehicleMake>Honda</vehicleMake>
        <vehicleModel>Accord</vehicleModel>
        <vehicleYear>2015</vehicleYear>
        <zipCode>19428</zipCode>
        <totalSRPCount>2110</totalSRPCount>
        <totalVDPCount>1</totalVDPCount>
    </consumerActivity>
    <consumerActivity>
        <summaryDate>2016-06-02 00:00:00</summaryDate>
        <vehicleMake>Honda</vehicleMake>
        <vehicleModel>Accord</vehicleModel>
        <vehicleYear>2015</vehicleYear>
        <zipCode>19428</zipCode>
        <totalSRPCount>2440</totalSRPCount>
        <totalVDPCount>0</totalVDPCount>
    </consumerActivity>
</consumerActivityResults>


Response JSON example
{
    "ConsumerActivityResults": {
        "consumerActivity": [
            {
                "summaryDate": "2016-05-15 00:00:00"
                "vehicleMake": "Honda"
                "vehicleModel": "Accord"
                "vehicleYear": "2015"
                "zipCode": "19428"
                "totalSRPCount": "1576"
                "totalVDPCount": "0"
            }
            {
                "summaryDate": "2016-05-16 00:00:00"
                "vehicleMake": "Honda"
                "vehicleModel": "Accord"
                "vehicleYear": "2015"
                "zipCode": "19428"
                "totalSRPCount": "1575"
                "totalVDPCount": "0"
            }
            {
                "summaryDate": "2016-05-17 00:00:00"
                "vehicleMake": "Honda"
                "vehicleModel": "Accord"
                "vehicleYear": "2015"
                "zipCode": "19428"
                "totalSRPCount": "2111"
                "totalVDPCount": "4"
            }
            {
                "summaryDate": "2016-05-18 00:00:00"
                "vehicleMake": "Honda"
                "vehicleModel": "Accord"
                "vehicleYear": "2015"
                "zipCode": "19428"
                "totalSRPCount": "1637"
                "totalVDPCount": "3"
            }
            {
                "summaryDate": "2016-05-19 00:00:00"
                "vehicleMake": "Honda"
                "vehicleModel": "Accord"
                "vehicleYear": "2015"
                "zipCode": "19428"
                "totalSRPCount": "1746"
                "totalVDPCount": "4"
            }
            {
                "summaryDate": "2016-05-20 00:00:00"
                "vehicleMake": "Honda"
                "vehicleModel": "Accord"
                "vehicleYear": "2015"
                "zipCode": "19428"
                "totalSRPCount": "1634"
                "totalVDPCount": "2"
            }
        ]
    }
}

 

No Match Response

No Match Response Example
{
  "ConsumerActivityResults": {
    "message": " No Cars.com Make_Model_Year match. We have the following  Model - AccordZ available for Year - 2015 Make - Honda",
    "consumerActivity": [
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Accord",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Accord Hybrid",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "CR-V",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Civic",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Civic Hybrid",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Fit",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Pilot",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Odyssey",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "Crosstour",
        "vehicleYear": "2015"
      },
      {
        "vehicleMake": "Honda",
        "vehicleModel": "CR-Z",
        "vehicleYear": "2015"
      }
    ]
  }
}

 

No Summary Data Response

No Summary Data Response Example
{
  "ConsumerActivityResults": {
    "message": " No summary data found for Year - 2015  Make - Honda Model - Accord in ZipCode(s) - [12345]",
    "consumerActivity": []
  }
}
Test
Method Type: 
GET