PRESSEPORTAL Presseportal Logo

Documentation

Stories of a specific topic


URL Scheme
/article/topic/ident [/media]

Arguments

name type description default
ident string identifier string of the topic required
media string requested media type optional

URL Parameters

name type description default
api_key string your api_key required
format string output format xml/json xml
start int start/offset of the result article list 0
limit int limit of articles in response 50
teaser int stories with teaser instead of fulltext 0
lang string language of the stories ( only in ch ) de

Response

name type description
success int successful request 1/0
error array if error was not successfull, ths node contains error code and error msg
request array information about the request, when successfull
content array list of stories, only when request successfull
  story array story data, see here for the details of the story node

Request example


https://api.presseportal.de/api/article/topic/sport?api_key=yourapikey
https://api.presseportal.de/api/article/topic/netzwelt/image?api_key=yourapikey&format=json
https://api.presseportal.ch/api/article/topic/panorama?api_key=yourapikey&lang=de&teaser=1
https://api.presseportal.ch/api/article/branche/finanzen?api_key=yourapikey&lang=fr&start=5&limit=10

Response example


<?xml version="1.0" encoding="UTF-8"?>
<response>
    <success>1</success>
    <request>
        <uri>https://api.presseportal.de/api/article/topic/sport</uri>
        <start>0</start>
        <limit>1</limit>
        <format>xml</format>
        <topic>Sport</topic>
        <teaser>1</teaser>
    </request>
    <content>
        <story>
            <id>3452976</id>
            <url>https://www.presseportal.de/pm/38533/3452976</url>
            <title>DTM-AUDIO-Service: Stracke von der Strecke bei der DTM
                DTM - Finale am Hockenheimring:  Freitag 14.- Sonntag 16.10. - wir sind on Air für Sie vor Ort.</title>
            <teaser>Hockenheim (ots) - An dieser Stelle werden die Radiokollegen den Audioservice der DTM herunter laden können. DTM-AUDIO-Service Stracke von der Strecke bei der DTM - Hockenheimring Liebe Kollegen Die DTM 2016 geht ins große Finale ...</teaser>
            <published>2016-10-11T11:52:08+0200</published>
            <language>de</language>
            <ressort>Sport</ressort>
            <company>
                <id>38533</id>
                <url>https://www.presseportal.de/nr/38533</url>
                <name>DTM</name>
            </company>
            <keywords>
                <keyword>Auto</keyword>
                <keyword>Motorsport</keyword>
                <keyword>Freizeit</keyword>
            </keywords>
            <highlight>0</highlight>
            <short>https://ots.de/34b030</short>
        </story>
    </content>
</response>

Content

API Terms

news aktuell provides you with news release content of our clients free of charge for non-commercial redistribution. This service is subject to our individual approval and based on the condition that you link back to the original material on www.presseportal.de and name us as content provider. With each release, our API provides our news service code “(ots)” as well as a link to the respective original material on www.presseportal.de. Please make sure that these are always included in your website or application.

In case of a breach of these or the Presseportal conditions, we reserve the right to deactivate your API key.

Example:
<url>https://www.presseportal.de/
pm/77055/1521219</url>

For further information and questions: presseportal@newsaktuell.de