Keyword

This endpoint lets you search for keywords that semantically summarize articles. An asterisk can serve as a wildcard or whitespace in your search query. Keywords are weighted by their overall frequency with a score from 0 to 100. Possible keyword types are: location, person, organisation or issue.

Endpoint

http://api.zeit.de/keyword

Parameter

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

Example

Request

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

Response

{
    "matches": [
        {
            "href": "http://www.zeit.de/schlagworte/orte/romanium/index",
            "score": 75,
            "type": "location",
            "uri": "http://api.zeit.de/keyword/romanium",
            "value": "Romanium"
        }
    ],
    "found": 116,
    "limit": 1,
    "offset": 0
}

Get keyword by ID

This endpoint provides a pre-filtered search for all articles tagged with a specific keyword. 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 /keyword/jane-mustermann?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-dolor", 
      "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/keyword/jane-mustermann",
  "href": "http://www.zeit.de/schlagworte/personen/jane-mustermann/index",
  "value": "Jane Mustermann",
  "lexical": "Mustermann, Jane"
  "type": "person",
  "score": 75,
  "limit": 1,
  "offset": 0,
  "found": 6
}