SC Sage

API Overview

SIGN UP

AUTHENTICATION

We authenticate using a simple API key token and password secret.

Only we can generate and provide an API token and secret. A user can only have a single valid API token and secret per account.

CACHING OF PROCESSED DATA AND CHART LINKS

We generally do not allow for the saving or caching of Processed Data responses, except for Chart Links, which provisions may change from time to time, with or without notice:

We allow caching of Chart Link responses for a period of up to 24 hours from the response header ‘Date’. At the expiration of the 24 hour period the Chart Link must be deleted from the client side server and a new API request made.

Because we update our data daily, cached Processed Data is stale within 24 hours. Therefore, we delete Chart Links from the server after 24 hours from the response header ‘Date’. As result cached Chart Links should be deleted and replaced prior to the expiration of the 24 hours period.

RATE LIMITS

Rate limits are set by your subscribed plan. Check our plans for current limits. If you run over the rate limit for your plan then you’ll get an error response from the API

VIN PRECHECKING

The VIN is an important parameter for many of our API endpoints as the VIN is used define the specification for the Processed Data and Chart Links. If a VIN is supported by SC Sage, and it is not present in our database at the time of an API request, we will add the VIN to the database at no charge. If a VIN is not supported by SC Sage or is not a valid VIN, the VIN will be rejected, which may result in charges.

For this reason, we do not charge for pre checking a VIN. Submitting a VIN check request allows for a VIN to be confirmed as in the database, or to be added to the database, or to fail as either invalid or not supported. If a VIN fails it should not be used in any other API endpoint requests as this will result in an error which may incur charges.

ENDPOINT OVERVIEW

We currently support the following endpoints which match our apps and charts.

API - ENDPOINTS

  • Endpoint 1 – VIN Check

  • Search the database to verify if a submitted VIN is present.

  • Endpoint 2 – Vehicle Description

  • Returns available basic description information for a submitted VIN.

  • Endpoint 3 – Market Basic Data

  • Returns average price and mileage, statistics for the make, model, submodel, body and year indicated by the submitted VIN.

  • Endpoint 4 – Market Extended Data

  • Returns market average and median, price and mileage, and high and low price and inventory count statistics for the make, model, submodel, body and year indicated by the submitted VIN.

  • Endpoint 5 – Market Advanced Data

  • Returns market average and median, price and mileage, high and low price and inventory count statistics for the make, model, submodel, body indicated by the submitted VIN, and the year parameter for ‘all’ years or the ‘exact’ year indicated by the submitted VIN, and the transmission parameter for ‘all’ transmissions or the ‘exact’ transmission indicated by the submitted VIN.

  • Endpoint 6 – Market Basic Timeline

  • Primarily for use in an iframe, this returns a URL for the Market Price Basic Timeline Chart in a blank SC Sage web page for the make, model, submodel, body indicated by the submitted VIN. The timeline parameter can be in months ‘3’ or ‘6’ or ‘12’ or ‘24’.

  • Endpoint 7 – Market Enhanced Timeline Dealer

  • Primarily for use in an iframe, this returns a URL for the Market Price Enhanced Timeline Chart in a blank SC Sage web page for the make, model, submodel, body indicated by the submitted VIN. The timeline parameter can be in months ‘3’ or ‘6’ or ‘12’ or ‘24’. The chart’s tooltip includes ‘Days to Date’ and ‘Market Inventory’ at each observed date in the chart.

  • Endpoint 8 –Market Enhanced Timeline Consumer

  • Primarily for use in an iframe, this returns a URL for the Market Price Enhanced Timeline Chart in a blank SC Sage web page for the make, model, submodel, body indicated by the submitted VIN. The timeline parameter can be in months ‘3’ or ‘6’ or ‘12’ or ‘24’. The chart’s tooltip does not include ‘Days to Date’ and ‘Market Inventory’ at each observed date in the chart.

  • Endpoint 9 – LN Mileage Price

  • Returns a current market price estimate for a vehicle based upon the vehicle’s actual mileage. And the theoretical percentage of the vehicle’s value which can be explained solely by mileage. These are calculated using logarithmic statistical modelling of price and miles. The estimate is generated using the current market inventory of vehicles matching the vehicle indicated by the submitted VIN. It combines all transmissions and model years. In some cases it combines bodies to maintain statistical significance when there are small market inventories – follow this link to view exceptions to the general body treatment.

  • Endpoint 10 – Normal Mileage Price

  • Returns a current market price estimate for a vehicle based upon the vehicle’s actual mileage. And the theoretical percentage of the vehicle’s value which can be explained solely by mileage. These are calculated using normal statistical modelling of price and miles. The estimate is generated using the current market inventory of vehicles matching the vehicle indicated by the submitted VIN. It combines all transmissions and model years. In some cases it combines bodies to maintain statistical significance when there are small market inventories – follow this link to view exceptions to the general body treatment.