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.
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
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.
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.
Our API responses are cached and use HTTP Caching headers like
Cache-Control and respond to headers like
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