Call your API: making a GET request

Every kimono account comes with a unique API key that must accompany every API call you make. Your API key is tied to your account - you can reset it from your account page.

Calling your API key is as easy as making a GET request to our API endpoint. This can be done from any number of languages including both server-side and client-side technologies.

The API endpoint URI is always as follows:

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

We've included examples for how you would call a kimono API using Curl, jQuery, Node, PHP Python and Ruby here but any other language able to make HTTP requests is valid as well.

The HTTP response will return JSON with important metadata about the API object as well as the actual data returned from the under the results property.

{
  "name": "Hackernews Top Item",
  "lastrunstatus": "success",
  "version": 1,
  "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"
        }
      }
    ]
  }
}


 

Note that API with on demand frequency will not include the nextrun property.

 

Powered by Zendesk