Series

This endpoint lets you search for journalistic series by name. An asterisk can serve as a wildcard or whitespace in your search query.

Endpoint

http://api.zeit.de/series

Parameter

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

Example

Request

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

Response

{
    "matches": [
      {
      "href": "http://www.zeit.de/serie/lorem-ipsum",
      "uri": "http://127.0.0.1:5000/api/series/lorem-ipsum",
      "value": "Lorem ipsum dolor set?"
      }
    ],
    "found": 7,
    "limit": 1,
    "offset": 0
}

Get series by ID

This endpoint provides a pre-filtered search for all articles written for a specific series. Deeper queries, pagination and partial field selection can be used to narrow down the match list.

Endpoint

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

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 /series/lorem-ipsum?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 ut labore et dolore magna aliquyam.",
      "title": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr.", 
      "href": "http://www.zeit.de/dolorem/lorem-ipsum/2012-12/Lorem-ipsum-que",
      "release_date": "2011-12-01T14:40:00.000Z", 
      "uri": "http://api.zeit.de/content/1111122299xxcc99aa", 
      "supertitle": "Lorem Ipsum", 
      "teaser_title": "Lorem ipsum dolor sit amet, consetetur sadipscing."
      "teaser_text": "Sicilia que es una magnifica maestrae."
    }
  ],
  "uri": "http://api.zeit.de/series/lorem-ipsum",
  "href": "http://www.zeit.de/series/lorem-ipsum",
  "value": "Lorem ipsum dolor set?",
  "limit": 1,
  "offset": 0,
  "found": 30
}