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.
  • Wenn Sie auf X Kommentare für einen Beitrag abrufen, der selbst eine Antwort ist, werden die Antworten auf diesen Beitrag zurückgegeben. Ein X-Beitrag, der eine eigene Konversation beginnt, ist unverändert und gibt weiterhin die Antworten aus der gesamten Konversation zurück.
  • 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

X-Abrechnungs- und Ratenlimit-Fehler

Ein Kommentar-Read für X kann an Ihrem eigenen X-Developer-Konto scheitern, meistens weil dort keine API-Credits mehr vorhanden sind oder weil Sie das Ratenlimit von X erreicht haben. Diese Fehler liefern einen typisierten Fehler statt einer leeren Kommentarliste, sodass ein Kontoproblem nie mit einem Beitrag ohne Kommentare verwechselt wird.
  • X gibt HTTP 402 zurück (keine API-Credits): Ayrshare gibt code: 416 mit HTTP 402 zurück.
  • X gibt HTTP 429 zurück (Ratenlimit): Ayrshare gibt code: 364 mit HTTP 429 zurück. Wenn der 429 von X besagt, dass das Konto keine Credits mehr hat, gibt Ayrshare stattdessen code: 416 zurück, da Warten das Problem nicht behebt.
  • Autorisierungsfehler geben code: 272 zurück, alle anderen X-Fehler geben code: 219 zurück, jeweils mit HTTP 400.
Bei einem Multiplattform-Read hat die Antwort auf oberster Ebene status: “partial”, und der fehlgeschlagene X-Zweig erscheint in errors[] mit status: “error”, genau wie oben beschrieben; ein Read für eine einzelne Plattform gibt den Fehler auf oberster Ebene zurück. Wenn X die Anfrage direkt ablehnt, wird der Fehler nicht zwischengespeichert, sodass der Read erneut versucht wird, sobald Sie wieder Kommentare anfordern. Ein X-Beitrag, der gelöscht wurde oder den Ihre X-Anmeldedaten nicht sehen können, gibt weiterhin ein leeres Array ohne Fehler zurück.

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