Beiträge

API + MCP

GET/v3/social-media/posts

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

Query-Parameter

offsetinteger

Die Anzahl der zu überspringenden Ergebnisse.

Standard:0

limitinteger

Die Anzahl der zurückzugebenden Ergebnisse.

Standard:50

order_directionstring

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

Zulässige Werte:ascdesc

order_bystring

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

Zulässige Werte:dateviewsunique_viewscommentslikes

date_tostring

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

date_fromstring

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

search_querystring

Textsuchanfrage zum Filtern von Beiträgen nach Inhalt.

author_idsstring

Kommagetrennte Liste von Benutzer-IDs der Autor*innen, nach denen gefiltert werden soll.

channel_idsstring

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

statusstringErforderlich

Die Phase im Veröffentlichungszyklus des Beitrags.

Zulässige Werte:publishedscheduleddraftfaileddeleted

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 or null

created_atstring

Zeitstempel, wann der Autor den Beitrag erstellt hat.

external_post_idstring or null

Plattformspezifische Beitragskennung.

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.

{ "posts": [ { "author_id": "string", "author_name": "string", "auto_comment": "string", "channels": [ { "channel_id": "string", "channel_kind": "string", "channel_username": "string", "channel_display_name": "string", "channel_profile_image_url": "string" } ], "created_at": "string", "external_post_id": "string", "permalink": "string", "post_id": 0, "status_timestamp": "string", "text_content": "string" } ] }