Quick Start Guide

Request an API key

Accessing our content requires an API key. To request one, simply sign up with your full name and a valid Email address. A key will be generated for you right here on this page. At the moment we offer free API-Access with a limit of 10,000 requests per day.

Sign up

Request API key

Authorize requests

All requests to our API must be authorized, so we know who plays with our data. To keep URLs simple and clean, the key should be sent as an X-Authorization header attached to your HTTP request.

Example

GET /{endpoint} HTTP/1.1
Host: http://api.zeit.de
X-Authorization: {api_key}

The key may also be sent as a query parameter, but a header is preferred.

Example

GET /{endpoint}?api_key={api_key} HTTP/1.1
Host: http://api.zeit.de

Available formats

The supported content types for now are JSON and JSONP, simple as that. The default is JSON.
To get JSONP, a callback parameter specifying the function's name is required.

Example

GET /{endpoint}?callback=myCallbackName HTTP/1.1
Response: myCallbackName({"result":"data"});

Error handling

If there was something wrong with your request or, if for some reason, we dropped the ball, you will receive an appropriate HTTP status code. The body will contain a JSON-encoded description of what might have been the problem.

Example

HTTP/1.0 401 UNAUTHORIZED
Content: {"description": "The provided API key seems to be invalid."}

Start exploring

Now, that you have learned the basics, head over to our API Explorer or digg into the documentation.