View historical versions

Kimono let's you access previous data returned by your API for the past 30 days (excluding on demand calls). A standard kimono API call, by default, will always return the latest data.

An API result will include in its response metadata the latest version number. In the example below, the API response returns version 6.

{
  "name": "Hackernews Top Item",
  "lastrunstatus": "success",
  "version": 6,
  "count": 1,
  "frequency": "daily",
  "newdata": true,
  "lastsuccess": "Wed Mar 05 2014 11:13:41 GMT-0800 (PST)",
  "nextrun": "Thu Mar 06 2014 11:13:49 GMT-0800 (PST)",
  "results": {
    "collection1": [
      {
        "property1": {
          "href": "https://blog.mozilla.org/research",
          "text": "Introducing the ‘mozjpeg’ Project"
        },
        "property2": "26 points",
        "property3": {
          "href": "https://news.ycombinator.com/item?id=7348814",
          "text": "1 comment"
        }
      }
    ]
  }
}

If we wanted to call version 3 of the data instead (assuming version 3 is less than 30 days old), we simply modify the API call URL with the version number 3 immediately preceding the API ID, like this:

https://www.kimonolabs.com/api/3/{API_ID}?apikey={YOUR_API_KEY}

Since the version number must be placed immediately preceding the API id, if you have already modified the API URL to retrieve CSV or RSS data instead of the standard JSON, you would add the desired version number after the csv or rss, like this:

https://www.kimonolabs.com/api/csv/3/{API_ID}?apikey={YOUR_API_KEY}

Your API's default is to only save versions of your data that are different (e.g., it will not store an identical data set). 

Powered by Zendesk