CIS Automotive API
This API provides access to our Automotive Data. Use of this API is subject to our Terms of Service For a quick start guide click here If you signed up…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
This API provides access to our Automotive Data. Use of this API is subject to our Terms of Service
For a quick start guide click here
If you signed up through RapidAPI make your test calls here
The general workflow is to: 1. Authenticate with your CIS Automotive API Keys to get a Json Web Token (JWT). Do not use RapidAPI keys.
- Then use that token as an argument when calling other endpoints.
Equivalent HTTP GET and POST methods are available for some endpoints.
Endpoints may appear more than once on this page if they are associated with multiple tags. eg "Sales Data", "Premium", "Pro Plan or Greater" To see which endpoints are included in different
plans look under the "X Plan or Greater" tags for the respective plan name.
If you signed up for our API through RapidAPI you can make your test calls on their platform .
Your RapidAPI credentials will not work on this page. Do not use your RapidAPI keys on this page.
If you signed up with us and have an account, you must first authenticate with your API Keys
and retrieve a Json Web Token (JWT) from the /getToken endpoint to access the other endpoints.
Your JWT is a required argument to all endpoints.
Endpoints 35
Supply Data
- GETDays worth of supply left on dealer lots
/daysSupply?jwt=string&brandName=string®ionName=REGION_STATE_CAAverage, median, standard deviation, population variance, and whole region average of the days of supply left on dealer lots for a given brand and region. The… - GETDays a vehicle takes to sell
/daysToSell?jwt=string&brandName=string®ionName=REGION_STATE_CAAverage, median, standard deviation, population variance, and whole region average of the number of days a vehicle spends on dealer lots for a given brand and…
Static Data
- GETGet a list of brand names
/getBrands?jwt=stringGet vehicle brand names. These names are used as arguments for other endpoints. The names are generally not case sensitive when used with other endpoints, but… - GETGet a list of model names including discontinued models
/getInactiveModels?jwt=string&brandName=stringGet all model names including discontinued models. Because these models are no longer built, or have very poor market performance they are not incuded in the… - GETGet a list of model names
/getModels?jwt=string&brandName=stringGet brand model names for currently active models. This endpoint does not return model names that have been discontinued or have sold less than 10 vehicles in… - GETGet a list of region names
/getRegions?jwt=stringGet region names. These names are used as arguments for other endpoints. The names are generally not case sensitive when used with other endpoints, but it is…
Dealership Data
- GETPremium. Dealers in a zip code.
/getDealers?jwt=string&zipCode=0Premium. Dealership information in a given zip code using the first 4 digits. Returns name, address, state, zipCode, and IDs. For example a call with the zip… - GETPremium. Dealers by ID
/getDealersByID?jwt=string&dealerID=0Premium. Dealership information using the internal ID. Returns name, address, state, zipCode, and ID for a single dealer in the same format as the /getDealers… - GETPremium. Dealers in a region.
/getDealersByRegion?jwt=string®ionName=REGION_STATE_CA&page=1Premium. Dealership information in a given region. Returns name, address, state, zipCode, and IDs. Results are paginated with up to 30 results per page.
Sales Data
- GETMarket share of a brand in region
/getRegionBrandMarketShare?jwt=string&brandName=string®ionName=REGION_STATE_CAMarket share of a given brand in a given region by number of vehicles sold over the last 45 days. - GETMarket share of all brands in region
/getRegionMarketShare?jwt=string®ionName=REGION_STATE_CAMarket share of a all brands in a given region by number of vehicles sold over the last 45 days. - GETUsed market share of model year by model
/modelYearDist?jwt=string&modelName=string&brandName=string®ionName=REGION_STATE_CAMarket share of used vehicles over the last 45 days by model and year. All values are relative to vehicles of the same model. For example: a percentOfMarket… - GETBrand sales by region and Day
/regionDailySales?jwt=string&brandName=string®ionName=string&day=2024-01-01Get regional sales by brand and day. Most recent data is typically only 2 days old for this endpoint. The Day field is in YYYY-MM-DD format. For example if… - GETPremium. Brand sales by region and month
/regionSales?jwt=string&brandName=string®ionName=string&month=2024-01-01Premium. Get regional sales by brand and month, broken down by day. Most recent data is typically only 2 days old for this endpoint. The month field is in… - GETTop models in a given region
/topModels?jwt=string®ionName=REGION_STATE_CASales ranking of different models by region over the last 45 days. The <strong>percentOfTopSales</strong> value is the percent of the top seller the model…
Authentication
- GETGet all Sub User Keys associated with your account.
/getSubUserKeys?apiID=string&apiKey=stringGet a list of your issued SubUser API Keys. Includes active and revoked keys. - GETGet a JWT from your API credentials
/getToken?apiID=string&apiKey=stringThis is the first function you should call. If you are accessing our API through a third party provider they will handle authenticating to our API for you and… - POSTGet a JWT from your API credentials
/getToken?apiID=string&apiKey=stringThis is the first function you should call. If you are accessing our API through a third party provider they will handle authenticating to our API for you and… - POSTGenerate a Sub User Key that can be used by your users to make API calls in frontend applications.
/makeSubUserKey?apiID=string&apiKey=string&siteName=localhostThis endpoint is only fully available to users with a paid plan. Users on Basic or Trial plans may only create keys valid on the "localhost" domain. This… - PUTRevoke a Sub User Key associated with your account.
/revokeSubUserKey?apiID=string&apiKey=string&subUserKeyUUID=stringRevoke a SubUser API Key with the given UUID. This action can not be undone.
Pricing Data
- GETStats on ask price of new vehicles
/listPrice?jwt=string&brandName=string®ionName=REGION_STATE_CAAverage, median, standard deviation, and population variance of the ask price of new vehicles over the last 15 days for a given brand and region. The… - GETStats on sale price of new vehicles
/salePrice?jwt=string&brandName=string®ionName=REGION_STATE_CAAverage, median, standard deviation, and population variance of the sale price of new vehicles over the last 15 days for a given brand and region. The… - GETHistogram of sales price of new vehicles by model
/salePriceHistogram?jwt=string&modelName=string&brandName=string®ionName=REGION_STATE_CAHistogram of the sale price of vehicles over the last 45 days for a given model and region. Price buckets are grouped in units of $1000 The available brand,…
Vehicle Data
- GETListings by Dealer ID
/listings?jwt=string&dealerID=0&page=1&newCars=trueSee /listings2 endpoint for more flexible listing search. Returns a dealer's listings over the last 45 days by dealer ID. The ID can be found by calling the… - GETFlexible Listing Search
/listings2?jwt=string&dealerID=0&zipCode=0&latitude=0&longitude=0&radius=0®ionName=string&brandName=string&modelName=string&modelYear=0&mileageLow=0&mileageHigh=0&startDate=2024-01-01&endDate=2024-01-01&daysBack=45&page=1&newCars=true&extendedSearch=falseGeneric getter for listings supporting a wide array of selection criteria. This is the new primary listing endpoint and we will phase out the older listing… - GETListings by Dealer ID and Date
/listingsByDate?jwt=string&dealerID=0&startDate=2024-01-01&endDate=2024-01-01&page=1&newCars=trueSee /listings2 endpoint for more flexible listing search. Returns a dealer's listings over the given timespan by dealer ID. The ID can be found by calling the… - GETListings by Region
/listingsByRegion?jwt=string®ionName=string&modelName=string&daysBack=10&page=1&newCars=trueSee /listings2 endpoint for more flexible listing search. Returns a dealer's listings over up to the last 45 days by region. Listing keys are: vin, askPrice,… - GETListings by Region and Date
/listingsByRegionAndDate?jwt=string®ionName=string&modelName=string&startDate=2024-01-01&endDate=2024-01-01&page=1&newCars=trueSee /listings2 endpoint for more flexible listing search. Returns listings active in a region in the given date range [startdate, endDate), or in other words… - GETListings by ZipCode
/listingsByZipCode?jwt=string&zipCode=0&page=1&newCars=true&modelName=stringSee /listings2 endpoint for more flexible listing search. Returns a dealer's listings over up to the last 45 days in the provided dealerhip's zip code. For… - GETListings by ZipCode and Date
/listingsByZipCodeAndDate?jwt=string&zipCode=0&startDate=2024-01-01&endDate=2024-01-01&page=1&newCars=true&modelName=stringSee /listings2 endpoint for more flexible listing search. Returns a dealer's listings over up to the last 45 days in the provided dealership's zip code. For… - GETPremium. Simple Vehicle Market Report
/similarSalePrice?jwt=string&vin=string®ionName=REGION_STATE_CA&daysBack=45&sameYear=falsePremium. Provides the average, stdDev, and count, of the sale price and mileage of similar new and used vehicles in a given region based off the provided VIN.… - GETPremium. Simple Vehicle Market Report Over Arbitrary Locations and Vehicles.
/valuation?jwt=string&vin=string&dealerID=0&zipCode=0&latitude=0&longitude=0&radius=0®ionName=string&mileageLow=0&mileageHigh=0&startDate=2024-01-01&endDate=2024-01-01&daysBack=45&newCars=false&extendedSearch=false&sameYear=falsePremium. Provides the average, stdDev, and count, of the sale price and mileage of similar new or used vehicles based off the provided VIN and matching the… - GETPremium. Simple Vehicle History Report
/vehicleHistory?jwt=string&vin=stringPremium. Provides a simple report detailing a vechicle's sales history at dealerships. Data includes the name of the dealership, dates it was for sale, price,… - GETChecks if a VIN appeared on the market on or after a given date.
/vehicleSeen?jwt=string&vin=string&afterDate=2024-01-01Checks our database to see if we have data on a VIN that appeared on the open market on or after the given date with a True/False response. This endpoint is… - GETVin decoder and Recall Info
/vinDecode?jwt=string&vin=string&passEmpty=false&includeRecall=trueDecodes the provided North American vin and provides recall information if available. We require at least the first 12 out of 17 characters in the vin to…
API details
- Authentication
- None declared in the description
- Operations
- 35 operations on 34 pathsGET 32POST 2PUT 1
- Main resources
- Vehicle Data 12Analyst Plan Or Greater 11Starter Plan Or Greater 11Premium 8Developer Plan Or Greater 6Sales Data 6Authentication 5Pricing Data 5Static Data 4Dealership Data 3
- Response formats
application/json- Description format
- OpenAPI 3.0.2, API version
1.0 - Links
- OpenAPI document
- Listed from
- APIs.guru OpenAPI Directory (CC0-1.0)
Source updated
How to test the CIS Automotive API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the CIS Automotive API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Days worth of supply left on dealer lots” (GET /daysSupply?jwt=string&brandName=string®ionName=REGION_STATE_CA), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the CIS Automotive API?
This API provides access to our Automotive Data. Use of this API is subject to our Terms of Service For a quick start guide click here If you signed up… It is listed under E-commerce and has 35 endpoints.
Who publishes the CIS Automotive API?
It is listed from Autodealerdata's public API description (an OpenAPI document), not published by Autodealerdata on Swastik Codes. Anyone who controls autodealerdata.com can claim the profile by adding a DNS TXT record.
How do I authenticate with the CIS Automotive API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the CIS Automotive API have?
35 operations on 34 paths (32 GET, 2 POST, 1 PUT). The largest groups are Vehicle Data, Analyst Plan Or Greater, Starter Plan Or Greater, Premium.
Is forking the CIS Automotive API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.