Skip to main content
GET
Rufen Sie Kommentare zu einem Beitrag über die Comments-API ab – anhand der Ayrshare Post ID, der Social Post ID, der Ayrshare Comment ID oder der Social Comment ID. Weitere Informationen zu den verschiedenen ID-Typen finden Sie in der Übersicht der Comments-API.
Bei Verwendung der Ayrshare Post ID sind keine Query-Parameter erforderlich.

Weitere Details zu Kommentaren

  • Die Kommentardaten werden für alle Plattformen alle 10 Minuten aktualisiert, mit Ausnahme von X. Aufgrund von Einschränkungen der X-API werden die Kommentardaten für X mithilfe einer Exponential-Backoff- Strategie aktualisiert, d. h. die Intervalle zwischen Aktualisierungen werden im Laufe der Zeit schrittweise länger.
  • In der Facebook-Antwort haben Antworten auf Antworten immer denselben parent.id.
  • Rufen Sie LinkedIn-Antworten auf Kommentare ab, indem Sie die Query-Parameter "commentId": true und "searchPlatformId": true setzen und die Social Comment ID im Pfad-Parameter übergeben.
  • Facebook und Instagram geben bis zu die 1.000 neuesten Kommentare zu einem Beitrag zurück. Kontaktieren Sie uns für höhere Limits im Enterprise Plan.
  • Für einen TikTok-Beitrag, der noch verarbeitet wird (dessen id ist "pending"), gibt Get Comments einen klaren „still processing”-Fehler (code: 288, HTTP 400) zurück – statt eines allgemeinen Fehlers. Versuchen Sie es erneut, sobald der tikTokPublished- Webhook auslöst oder /history die aufgelöste Video-ID anzeigt.

Multiplattform-Reads & Teilerfolg

Wenn Sie Kommentare mit der Ayrshare Post ID anfordern, kann der Beitrag mehrere Plattformen umfassen. Ayrshare fächert eine Anfrage in einen Zweig („leg”) pro Plattform auf und gibt einen Teilerfolg zurück, wenn einige Zweige erfolgreich sind und andere fehlschlagen – die Kommentardaten der intakten Plattformen werden stets zurückgegeben, und jeder fehlgeschlagene Zweig wird in einem obersten errors[]-Array aufgeführt.
  • Einige Plattformen erfolgreich, einige fehlgeschlagen: Die Antwort ist HTTP 200 mit status: “partial”. Die intakten Plattformblöcke werden wie gewohnt zurückgegeben, und ein oberstes errors[]-Array listet jeden fehlgeschlagenen Zweig mit seiner platform, seinem status, code, seiner message und seiner id auf.
  • Alle Plattformen fehlgeschlagen: Die Antwort hat status: “error” und das vollständige errors[]-Array. Der HTTP-Status wird vom repräsentativen Fehlercode auf oberster Ebene abgeleitet. Code 485 wird auf HTTP 404 abgebildet; andere repräsentative Codes verwenden ihre eigenen Zuordnungen.
  • Alle Plattformen erfolgreich: Die Antwort ist unverändert – HTTP 200, status: “success” und kein errors[]-Schlüssel.
Verhaltensänderung – prüfen Sie errors[], verzweigen Sie nicht anhand des HTTP-Status. Da ein plattformübergreifender Read mit einem fehlgeschlagenen Zweig nun HTTP 200 zurückgibt, anstatt die gesamte Antwort auf einen Fehler zu reduzieren, sollten Integratoren stets prüfen, ob ein oberstes errors[]-Array vorhanden ist, um Fehler auf Plattformebene zu erkennen, statt sich allein auf den HTTP-Statuscode zu verlassen.

Abgelaufene oder nicht verfügbare Instagram-/Facebook-Story-Kommentare

Ein Instagram- oder Facebook-Story-Kommentar-Zweig, der abgelaufen oder nicht verfügbar ist – sodass seine Kommentare nicht abgerufen werden können – erscheint in errors[] mit Code 485. Eine repräsentative Instagram-Meldung lautet “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” Wenn eine andere Plattform erfolgreich ist, werden deren Kommentare dennoch zurückgegeben und die Gesamtantwort ist HTTP 200. Bei einer Antwort mit vollständigem Fehlschlag wird der repräsentative Code 485 auf HTTP 404 abgebildet; andere repräsentative Codes verwenden ihre eigenen Zuordnungen. Gleichen Sie den code (485) ab, nicht den exakten Meldungstext.

Beispiel: Teilerfolgs-Antwort

200: Teilerfolg

Header-Parameter

Pfad-Parameter

Query-Parameter

boolean
Standard:false
Wenn Sie Kommentare zu einem über Ayrshare veröffentlichten Beitrag mit der Ayrshare Post ID abrufen, lassen Sie dieses Feld weg – es hat den Standardwert false. Wenn Sie Kommentare mit der Social Post ID oder der Social Comment ID abrufen (also der von den sozialen Netzwerken erzeugten ID), setzen Sie den Wert auf true.
boolean
Standard:false
Wenn Sie Kommentare mit der Social Comment ID abrufen (also der von den sozialen Netzwerken erzeugten Kommentar-ID), setzen Sie den Wert auf true.Beim Abrufen von Kommentaren mit der Ayrshare Post ID oder der Social Post ID lassen Sie dieses Feld weg – es hat den Standardwert false.
Wenn Sie den Query-Parameter commentId verwenden, müssen Sie außerdem searchPlatformId auf true setzen.
string
Erforderlich, wenn searchPlatformId oder commentId true ist.Wann zu verwenden:
  • Bei Verwendung der Social Post ID und des Felds "searchPlatformId": true. Unterstützte Plattformen: bluesky, facebook, instagram, linkedin, threads, tiktok, twitter, youtube.
  • Bei Verwendung der Social Comment ID und der Felder "searchPlatformId": true und "commentId": true. Unterstützte Plattformen: facebook, instagram, linkedin.
  • Bei Verwendung der Ayrshare Post ID lassen Sie dieses Feld weg – Kommentare werden von allen Plattformen zurückgegeben, auf denen der ursprüngliche Beitrag veröffentlicht wurde.

Beispiele für Comment-GET-Anfragen