Statistiken und Kommentare zu einem Beitrag abrufen

Name	Typ	Erforderlich	Beschreibung
postId	string	erforderlich	Post UUID, the `socialPostId` returned by POST /social/posts.

Name	Typ	Erforderlich	Beschreibung	Standard
socialConnectedChannelId	string	erforderlich	UUID of the connection to read insights for, the `id` of a row from the brand's connections list. Insights are per channel, so this is required even when the post targeted one platform. Note the name: this endpoint takes `socialConnectedChannelId`, while disconnect takes `socialProfileConnectedChannelId` for the same ID.	—

Gibt zurück, was die Plattform zu einem veröffentlichten Beitrag auf einem Kanal meldet: seine Engagement-Metriken und die dazu hinterlassenen Kommentare.

Anwendungsfall: eine Engagement-Ansicht pro Beitrag. Wenn ein Kunde einen veröffentlichten Beitrag in Ihrer Benutzeroberfläche öffnet, rufen Sie GET /social/posts/{postId} für die Kanalliste auf und rufen Sie dann diesen Endpunkt einmal pro Kanal mit dem jeweiligen id des Kanals auf. Parsen Sie insights, zeigen Sie die Metriken an, die Sie erkennen, und ignorieren Sie den Rest — so führt das Hinzufügen eines Feldes durch eine Plattform niemals zu einem Fehler auf Ihrer Seite.

Anwendungsfall: Kommentare anzeigen, die eine Antwort benötigen. Rufen Sie diesen Endpunkt regelmäßig für kürzlich veröffentlichte Beiträge ab und leiten Sie neue Einträge aus dem geparsten Array comments in Ihren eigenen Posteingang weiter. Beachten Sie, dass dieser Endpunkt nur Lesezugriff bietet: Das Beantworten eines Kommentars erfolgt auf der Plattform, nicht über die Listings API.

Hinweise.

socialConnectedChannelId ist erforderlich und entspricht dem id der Verbindung aus den Verbindungen der Marke — nicht dem referenceId der Plattform. Statistiken beziehen sich immer auf einen einzelnen Kanal, da die Zahlen aus der API dieser Plattform stammen.
Der Kanal muss zu derselben Marke gehören wie der Beitrag. Wird ein Beitrag mit der Verbindung einer anderen Marke kombiniert, gibt der Endpunkt SY95052 zurück.
Nur veröffentlichte Beiträge haben Statistiken. Für einen Beitrag, der noch den Status SCHEDULED hat oder dessen Veröffentlichung auf diesem Kanal fehlgeschlagen ist, werden leere Nutzdaten statt eines Fehlers zurückgegeben. Prüfen Sie daher connectedChannels[].status beim Beitrag, bevor Sie Schlussfolgerungen ziehen.
Die Aktualität der Metriken hängt von der Plattform ab, was bei den meisten Plattformen eine Verzögerung von Minuten bis zu einigen Stunden nach der Veröffentlichung bedeutet. Fragen Sie die Daten in regelmäßigen Abständen ab, statt unmittelbar nach dem Wechsel von connectedChannels[].status zu SUCCESS Zahlen zu erwarten.
Die Anzahl der Kommentare ist auf das begrenzt, was die Plattform auf einer Seite zurückgibt; dieser Endpunkt ruft keine weiteren Seiten ab.

Antworten

200The platform's engagement payload and comments. Both fields are JSON strings whose keys are set by the platform, not by Listings API: parse them before reading.

Response

{  "data": {    "getPostInsightsAndCommentsForSocialChannel": {      "insights": "{\"impressions\": 4820, \"reach\": 3915, \"likes\": 212, \"comments\": 18, \"saved\": 44, \"shares\": 9, \"profile_visits\": 61}",      "comments": "[{\"id\": \"17912345678901234\", \"username\": \"marta.builds\", \"text\": \"That oak finish is beautiful. Do you ship?\", \"like_count\": 3, \"timestamp\": \"2026-10-02T15:12:44+0000\"}, {\"id\": \"17912345678905678\", \"username\": \"eastsidehome\", \"text\": \"Stopping by Saturday!\", \"like_count\": 0, \"timestamp\": \"2026-10-02T18:40:02+0000\"}]"    }  }}

401Unauthenticated, missing or invalid API key.

404No post with that ID on this account, or the connection does not belong to the post's brand (`SY95052`).

Statistiken und Kommentare zu einem Beitrag abrufen

Parameter

Pfad

Query

Antworten