Overview

Our API gives you access to most of our data. The Eet.nu API is organized around REST. We aim to have simple, predictable URLs for our resources. We use built-in HTTP features like HTTP Verbs, HTTP Authentication and return JSON in all our responses.

Attribution

We require you to attribute Eet.nu when using our data.

If you are creating a web application, we require a link to Eet.nu on every page that displays our data. These links must be normal links, and they may not include the rel="nofollow" attribute.

If you are creating a mobile or desktop application powered primarely by Eet.nu, we require the Eet.nu logo to be prominently displayed on your application's splash or default screen.

If you use our information in some sections of your application (for example to show reviews of a venue), you are required to attribute us on that screen. This can be done by displaying the Eet.nu logo or with text indicating that the data is powered by Eet.nu.

Versioning

Currently only 1 version of our API exists, that version is 1. In the future, we might introduce features that are not backwards compatible. If this happens, we will release a new version, but support our older version.

If you want to use a specific version of our API, you can use the Accept header. For example, to request information with version 1 of our API from the command line, try the following:

$ curl -I -H "Accept: application/json, application/vnd.eet-nu;ver=1" https://api.eet.nu/venues
HTTP/1.1 200 OK
Status: 200 OK
Content-Type: application/json; charset=utf-8

Not passing a version will return the newest version of the API.

Responses

All API responses are JSON and we support JSONP with the callback query parameter.

Our API responses are cached and use HTTP Caching headers like Last-Modified, ETag and Cache-Control and respond to headers like If-None-Match and If-Modified-Since to control caching.

$ curl -I https://api.eet.nu/venues
HTTP/1.1 200 OK
Status: 200 OK
Content-Type: application/json; charset=utf-8
ETag: "a0bceffbfe7d6f4ebe92ef20dd4b8e29"
Last-Modified: Sun, 05 Feb 2012 13:06:32 GMT
Cache-Control: public, max-age=0