Content

This endpoint exposes an unfiltered search for articles. You can set search queries, paginate, sort and partially select the fields, that should be returned. Articles, that match your query, are returned in the matches array with a reduced set of meta data. The full set of data is only available at /content/{id}.

Endpoint

http://api.zeit.de/content

Parameter

q*:* the main search query
fields* partially select output fields
limit10 limit the amount of matches to return
offset0 offset for the list of matches

Example

Request

GET /content?q=dolore&limit=1 HTTP/1.1
Host: http://api.zeit.de
X-Authorization: abcdefg1234xyz56789

Response

{
  "matches": [
    {
        "subtitle": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
            sed diam nonumy eirmod tempor invidunt.",
        "uuid": "1111122299xxcc99aa", 
        "title": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr.",
        "href": "http://www.zeit.de/lorem/ipsum/2012-12/Lorem-ipsum-dolor-sit",
        "release_date": "2011-12-01T14:40:00.000Z", 
        "uri": "http://api.zeit.de/content/1111122299xxcc99aa",
        "snippet": "tempor invidunt ut labore et dolore magna aliquyam
            erat, sed diam voluptua"
        "supertitle": "Lorem Ipsum", 
        "teaser_title": "Lorem ipsum dolor sit amet, consetetur sadipscing.",
        "teaser_text": "Stet clita kasd gubergren, no sea takimata sanctus est
            Lorem ipsum dolor sit amet."
    }
],
  "found": 148,
  "limit": 1,
  "offset": 0
}

Get content by ID

Requesting a content object by its ID will get you all available data for that article. Partial field selection is available, if not all fields are of interest.

Endpoint

http://api.zeit.de/content/{id}

Example

Request

GET /content/1111122299xxcc99aa HTTP/1.1
Host: http://api.zeit.de
X-Authorization: abcdefg1234xyz56789

Response

{
    "title": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr.",
    "release_date": "2011-12-01T14:40:00.000Z", 
    "uri": "http://api.zeit.de/content/1111122299xxcc99aa",
    "supertitle": "Lorem Ipsum", 
    "href": "http://www.zeit.de/lorem/ipsum/2012-12/Lorem-ipsum-dolor-sit-que",
    "teaser_text": "Stet clita kasd gubergren, no sea takimata sanctus est
        Lorem ipsum dolor sit amet."
    "teaser_title": "Lorem ipsum dolor sit amet, consetetur sadipscing.",
    "creators": [
        {
            "uri": "http://api.zeit.de/author/James-Mustermann",
            "rel": "author",
            "name": "James Mustermann"
        }
    ],
    "relations": [
        {
            "uri": "http://api.zeit.de/content/55555ccc333aaawww",
            "rel": "related",
            "name": "Eirmod tempor invidunt ut labore"
        },
        {
            "uri": "http://api.zeit.de/content/333322ssssQQQrrrr",
            "rel": "related",
            "name": "No sea takimata sanctus est"
        }
    ],
    "keywords": [
        {
            "uri": "http://api.zeit.de/keyword/lorem",
            "rel": "location",
            "name": "Lorem"
        },
        {
            "uri": "http://api.zeit.de/keyword/ipsum-set",
            "rel": "subject",
            "name": "Ipsum Set"
        }
    ],
    "categories": [
        {
            "uri": "http://api.zeit.de/department/lorem",
            "rel": "department",
            "name": "Lorem"
        },
        {
            "uri": "http://api.zeit.de/product/dolores",
            "rel": "product",
            "name": "Dolores"
        },
        {
            "uri": "http://api.zeit.de/department/ipsum",
            "rel": "sub_department",
            "name": "Ipsum"
        }
    ]
}