Docs
Dokumentation durchsuchen...⌘K

Beiträge

API + MCP
GET/v3/social-media/posts

Anfragen an diesen Endpunkt sind kostenlos und verbrauchen keine API-Einheiten.

Query-Parameter

statusstringErforderlich

Die Phase im Veröffentlichungszyklus des Beitrags.

Zulässige Werte:publishedscheduleddraftfaileddeleted
channel_idsstring

Kommagetrennte Liste der Kanal-IDs, nach denen gefiltert werden soll.

author_idsstring

Kommagetrennte Liste der Benutzer-IDs der Autoren, nach denen gefiltert werden soll.

search_querystring

Textsuchanfrage, um Beiträge anhand ihres Inhalts zu filtern.

date_fromstring (date)

Das Startdatum des historischen Zeitraums im Format YYYY-MM-DD.

date_tostring (date)

Das Enddatum des historischen Zeitraums im Format YYYY-MM-DD.

order_bystring

Sortierfeld für Beiträge. Eine kennzahlenbasierte Sortierung gilt nur für veröffentlichte Beiträge.

Zulässige Werte:dateviewsunique_viewscommentslikes
order_directionstring

Die Reihenfolge, in der Ergebnisse zurückgegeben werden: aufsteigend oder absteigend.

Zulässige Werte:ascdesc
limitinteger

Die Anzahl der zurückzugebenden Ergebnisse.

Standard:50
offsetinteger

Die Anzahl der zu überspringenden Ergebnisse.

Standard:0
outputstring

Das Ausgabeformat.

Zulässige Werte:jsonphp

Antworten

postsarray<object>
author_idstring or null

Eindeutige Kennung des Autors.

author_namestring or null

Name des Autors.

auto_commentstring or null

Text des Auto-Kommentars, der nach der Veröffentlichung gepostet wird.

channelsarray<object>

Social-Media-Kanäle, die dem Beitrag zugeordnet sind.

channel_idstring
channel_kindstring
channel_usernamestring
channel_display_namestring
channel_profile_image_urlstring (url) or null
created_atstring (date-time)

Zeitstempel, wann der Autor den Beitrag erstellt hat.

external_post_idstring or null

Plattformspezifischer Beitragsbezeichner.

permalinkstring or null

URL des veröffentlichten Beitrags auf der Plattform.

post_idinteger

Eindeutige Kennung für den Beitrag.

status_timestampstring

Zeitstempel, der dem aktuellen Status zugeordnet ist.

text_contentstring

Textinhalt des Beitrags.