Author

Search all authors

This endpoint lets you search for authors by their name. The result is a list of possible matches with a displayable value, a URI to an article overview within the API and, if available, a link to all articles by this author on www.zeit.de.

Endpoint

http://api.zeit.de/author

Parameter

q* main search query with asterisk as wildcard
fieldshref,id,type,uri,value partially select output fields
limit10 amount of matches to return
offset0 offset for the list of matches

Example

Request

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

Response

{
  "matches": [
    {
      "href": "http://www.zeit.de/autoren/J/James_Mustermann/index.xml",
      "type": "author",
      "id": "James-Mustermann",
      "value": "James Mustermann",
      "uri": "http://api.zeit.de/author/James-Mustermann"
    }
  ], 
  "found": 3, 
  "limit": 1, 
  "offset": 0
}

Get author by ID

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

Endpoint

http://api.zeit.de/author/{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 /author/Jasmine-Mustermann?limit=1 HTTP/1.1
Host: http://api.zeit.de
X-Authorization: abcdefg1234xyz56789

Response

{
  "value": "Jasmine Mustermann", 
  "matches": [
    {
      "subtitle": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr,
        sed diam nonumy eirmod tempor invidunt ut labore et dolore magna.", 
      "title": "Lorem ipsum dolor sit amet, consetetur sadipscing elitr.", 
      "href": "http://www.zeit.de/department/sub/2012-12/Lorem-ipsum", 
      "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."
    }
  ], 
  "uri": "http://api.zeit.de/author/Jasmine-Mustermann",
  "type": "author",
  "limit": 1, 
  "offset": 0, 
  "found": 12
}