Endpoints Socialmedia

Suche durch Socialmedia Beiträge aus dem Redaktionsnetzwerk der Hessen Agentur.

GET

Request Parameter

Parameters Description Values Note
Sources Ein Komma-separierter String der Kurznamen von den Quellen deren Artikel du anzeigen möchtest. Hessen Agentur: HEA HTAI: HTAI Kreativwirtschaft Hessen: KWH  Es muss eine Quelle angegeben werden! Wenn mehrere Quellen angegeben werden, wird der Link zu dem Projekt generiert, dass den Artikel urprünglich erstellt hat.
SmSources Ein Komma-separierter String der IDs von den Quellen deren Feedcontent du anzeigen möchtest. Entdecke Hessens Schätze [instagram]: lm07425 Feels like Hessen [instagram]: zv93507 HA Hessen Agentur [twitter]: bg81334 HA Hessen Agentur GmbH [facebook]: yi05985 HA Hessen Agentur GmbH [instagram]: fk64185 Hessen Agentur [youtube]: hc97720 Hessen Tourismus [instagram]: bf87436 Hessen Trade & Invest GmbH [facebook]: pp48316 HessenTourismus [youtube]: ro37830 HTAI [twitter]: pl42303 Kultur in Hessen [youtube]: tx75611 
BlogSources Ein Komma-separierter String der Blogs, deren Posts du anzeigen möchtest. HA Blog: hessisch.de 
PageSize
int
Die Anzahl der Ergebnisse die per Seite zurückgegeben werden. 20 ist der Voreingestellte Wert, 100 ist das Maximum.
Page
int
Nutze dies um durch die Unter-Ergebnisse des Gesamtergebnisses zu navigieren, wenn das Gesamtergebnis größer als die PageSize ist.
ApiKey
REQUIRED
Dein ApiKey. Alternativ kannst du ihn auch via X-API-Key HTTP header nutzen.
From Ein Datum für den ältesten Artikel der gefunden werden kann. Das Format muss im ISO 8601 Format sein. Beispiel 2020-26-11
To Ein Datum für den neusten Artikel der gefunden werden kann. Das Format muss im ISO 8601 Format sein. Beispiel 2020-26-11
SortOrder Die Sortierart für die Ergebnismenge. Möglich sind Asc Desc. Der Voreingestellte Wert ist Desc.
Type
string
Der Typ des Artikels. Möglich sind Instagram Youtube Twitter Facebook News Termin Blog. Der Voreingestellte Wert is keiner, bedeutet es werden alle Typen gesucht. Wenn ein Typ angegeben wird, muss auch eine source bei News/Termin, bzw eine SmSource bei allen anderen Typen angegeben werden.

Response object

Parameters Description Values Note
Status
string
War der Aufruf Erfolgreich oder nicht. OK Error 
TotalResults
int
Die Zahl der verfügbaren Ergebnisse zu deiner Anfrage.
ID
int
ID des Artikels.
NextID
int
ID des nächsten Artikels.
PreviousID
int
ID des vorherigen Artikels.
Socialmedia
array[]
Das Ergebnis deiner Anfrage.
Source
string
Der Projektname name der Quelle, wo dieser Artikel herkommt.
Title
string
Die Headline dieses Artikels.
Description
string
Ein Teaser des Artikels.
Url
string
Die direkte URL zu dem Artikel.
PublishedAt
string
Das Datum wann der Artikel veröffentlicht wurde.
Type
string
Der Typ des Artikels. Möglich sind Instagram Youtube Twitter Facebook News Termin
MediaType
string
Der Typ des Artikels. Möglich sind video/mp4 image application/x-shockwave-flash video .
PostCounter
array
Views,likes,dislikes,comments.
UrlToImage
string
Die direkte URL zum Posterbild des Artikels, max 1920px breit. Bei den Instagrambildern kann keine Größenänderung vorgenommen werden, die Bilder erscheinen immer in 640x640px.
UrlToThumbImage
string
Die direkte URL zum Thumb des Artikels, 200px breit. Bei den Instagrambildern kann keine Größenänderung vorgenommen werden, die Bilder erscheinen immer in 640x640px.
UrlToPreviewImage
string
Die direkte URL zum Thumb des Artikels, 500px breit. Bei den Instagrambildern kann keine Größenänderung vorgenommen werden, die Bilder erscheinen immer in 640x640px.