Keyword
Search all keywords
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
}