REST APIGET

Posteingang: Kommentare

Listen Sie die Kommentare zu Ihren Beiträgen auf Facebook, Instagram, Threads, YouTube, LinkedIn, Bluesky und Mastodon auf und antworten, blenden aus, liken, löschen oder erledigen Sie sie.

GEThttps://post.adaptlypost.com/post/api/v1/inbox/comments

Gibt Kommentare zu den Beiträgen Ihrer Konten zurück, die neuesten zuerst. Antwortet mit { comments, total, hasMore, nextCursor }.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.readRollen und Berechtigungen

Jede Rolle hat inbox.read, daher kann jeder gültige Schlüssel den Posteingang lesen.

Abfrageparameter

Parameter	Typ	Beschreibung
`accountIds`	`string[]`	Nur diese Konten, mit der id aus GET /social-accounts. Schlüssel wiederholen oder Werte mit Kommas trennen. Bis zu 50
`platforms`	`PlatformType[]`	Nur diese Plattformen. Schlüssel wiederholen oder Werte mit Kommas trennen
`statuses`	`InboxStatus[]`	Nur Einträge in diesen Zuständen: UNREAD, READ oder DONE. Schlüssel wiederholen oder Werte mit Kommas trennen
`since`	`string (ISO 8601)`	Nur Einträge, die auf der Plattform zu oder nach diesem Zeitpunkt erstellt wurden
`search`	`string`	Suchtext
`postId`	`string`	Nur Kommentare zu diesem AdaptlyPost-Beitrag, mit seiner id aus /social-posts
`platformPostId`	`string`	Nur Kommentare zu diesem Beitrag, mit der eigenen Beitrags-ID der Plattform
`limit`	`number`	Einträge pro Seite, 1 bis 100. Standard 25
`cursor`	`string`	Der nextCursor der vorherigen Seite. Auf der letzten Seite ist nextCursor null

Etwa 10 Minuten, nicht in Echtzeit

AdaptlyPost liest jedes verbundene Konto alle 10 Minuten und speichert, was es findet. Die Listen antworten aus dieser Kopie, daher erscheint ein neuer Kommentar, eine Erwähnung, Nachricht oder Bewertung innerhalb von etwa 10 Minuten. POST /api/v1/inbox/refresh fordert sofort einen Lesevorgang an. Webhook-Ereignisse stammen aus denselben Lesevorgängen.

Kanäle, die eine neue Verbindung brauchen

Jeder Kanal ist über die API erreichbar. Fehlt einer Verbindung die Plattform-Berechtigung für einen Kanal oder eine Aktion, auch eine, die die Plattform für AdaptlyPost noch prüft, zeigt GET /api/v1/inbox/summary den Kanal als RECONNECT_REQUIRED, und jeder Schreibzugriff darauf antwortet mit 403 inbox_reconnect_required. Ein abgelaufenes Token antwortet genauso. Bitten Sie die Person, das Konto in AdaptlyPost neu zu verbinden; ein erneuter Versuch hilft nicht.

Felder eines Kommentars

Feld	Beschreibung
`id`	Kommentar-ID. Verwenden Sie sie mit den Endpunkten unten
`accountId`	Das Konto, zu dem der Eintrag gehört: seine id aus GET /social-accounts
`platform`	Die Plattform als PlatformType
`accountName`	Anzeigename dieses Kontos
`postId`	Die AdaptlyPost-Beitrags-ID oder null, wenn der Beitrag nicht über AdaptlyPost veröffentlicht wurde
`platformPostId`	Die ID der Plattform für den Beitrag, unter dem der Kommentar steht
`postText`	Text dieses Beitrags
`postPermalink`	Link zu diesem Beitrag
`platformCommentId`	Die ID der Plattform für den Kommentar
`parentPlatformCommentId`	Die ID der Plattform für den Kommentar, auf den dieser antwortet, oder null bei einem Kommentar der obersten Ebene
`isReply`	True, wenn der Kommentar auf einen anderen Kommentar antwortet
`author`	Wer es geschrieben hat: id (die Nutzer-ID der Plattform), name, username und avatarUrl. id, username und avatarUrl können null sein
`text`	Der Kommentartext
`permalink`	Öffentlicher Link auf der Plattform oder null, wenn die Plattform keinen liefert
`likeCount`	Likes des Kommentars oder null, wenn die Plattform sie nicht meldet
`createdAt`	Wann es auf der Plattform erstellt wurde
`status`	UNREAD, READ oder DONE. Nur AdaptlyPost speichert diesen Zustand; die Plattform sieht ihn nicht
`isHidden`	True, wenn der Kommentar auf der Plattform ausgeblendet ist
`isOwn`	True, wenn Ihr Konto ihn geschrieben hat
`replied`	True, wenn Ihr Konto darunter geantwortet hat, aus AdaptlyPost oder aus der App der Plattform
`repliedAt`	Wann Ihr Konto zuletzt geantwortet hat, oder null
`likedByAccount`	True, wenn Ihr Konto ihn geliked hat
`capabilities`	canReply, canHide, canDelete und canLike: was dieser Kommentar erlaubt. Prüfen Sie sie, bevor Sie eine Aktion aufrufen

Einen Verlauf lesen

GEThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id

Gibt { comment, parent, replies } zurück: den Kommentar, den Kommentar, auf den er antwortet (null bei einem Kommentar der obersten Ebene), und die Antworten darunter. Eine unbekannte ID antwortet mit 404 inbox_item_not_found.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.readRollen und Berechtigungen

Auf einen Kommentar antworten

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/reply

Veröffentlicht eine Antwort des Kontos unter dem Kommentar und antwortet mit 201 und der neuen Antwort als Kommentar.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

Schreibzugriffe brauchen inbox.reply (Admin und Redakteur) und einen aktiven AdaptlyPost-Tarif. Ohne Tarif antworten sie mit 403 subscription_required.

Body-Parameter

Parameter	Typ	Beschreibung
`text`ERFORDERLICH	`string`	Die Antwort. Es gilt das Kommentarlimit der Plattform: LinkedIn 1250, Threads 500, Bluesky 300, Mastodon 500, YouTube 10000, Facebook 8000 und Instagram 2200 Zeichen

Ausblenden, liken und löschen

Jede Aktion antwortet mit 400 inbox_action_unsupported, wenn die Plattform oder der Kommentar sie nicht erlaubt. capabilities am Kommentar zeigt das vorab.

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/hide

Blendet den Kommentar auf der Plattform aus und antwortet mit 200 und dem Kommentar.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/unhide

Zeigt einen ausgeblendeten Kommentar wieder an und antwortet mit 200 und dem Kommentar.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/like

Liked den Kommentar mit dem Konto und antwortet mit 200 und dem Kommentar.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

DELETEhttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id/like

Entfernt das Like des Kontos und antwortet mit 200 und dem Kommentar.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

DELETEhttps://post.adaptlypost.com/post/api/v1/inbox/comments/:id

Löscht den Kommentar auf der Plattform und im AdaptlyPost-Posteingang und antwortet mit 200 { "deleted": true }.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

Löschen und Liken pro Plattform

Was jede Plattform das Konto löschen und liken lässt. Auf Threads braucht das Löschen die Berechtigung threads_delete, daher antwortet eine ältere Threads-Verbindung mit 403 inbox_reconnect_required, bis sie neu verbunden wird.

Plattform	Löschen	Liken und Like entfernen
`FACEBOOK`	Jeder Kommentar zu Beiträgen der Seite	Ja
`INSTAGRAM`	Jeder Kommentar zu Beiträgen des Kontos	Nein
`YOUTUBE`	Nur die eigenen Kommentare des Kanals	Nein
`THREADS`	Nur die eigenen Antworten des Kontos	Nein
`BLUESKY`	Nur die eigenen Antworten des Kontos	Ja
`MASTODON`	Nur die eigenen Antworten des Kontos	Ja, als Favorit
`LINKEDIN`	Jeder Kommentar zu Beiträgen des Unternehmens	Ja

Als gelesen oder erledigt markieren

POSThttps://post.adaptlypost.com/post/api/v1/inbox/comments/status

Setzt den Status von bis zu 100 Kommentaren und antwortet mit { comments, unreadCount }.

API-Schlüssel (Bearer-Token)

Berechtigung:inbox.replyRollen und Berechtigungen

Body-Parameter

Parameter	Typ	Beschreibung
`ids`ERFORDERLICH	`string[]`	1 bis 100 IDs aus der Liste
`status`ERFORDERLICH	`InboxStatus`	UNREAD, READ oder DONE

Ablehnungen

Ein abgelehnter Aufruf antwortet mit { statusCode, error, code, message }. Werten Sie code aus. message erklärt die Ablehnung in Worten.

Code	Status	Wann, und was zu tun ist
`inbox_item_not_found`	404	Die ID existiert nicht oder gehört zu einem anderen Workspace. Abbrechen
`inbox_action_unsupported`	400	Die Plattform oder dieser Eintrag erlaubt dieses Ausblenden, Löschen oder Liken nicht. capabilities sagt, was möglich ist. Abbrechen
`inbox_reconnect_required`	403	Der Verbindung fehlt die Berechtigung für diesen Kanal oder diese Aktion, auch eine, die die Plattform noch prüft, oder ihr Token ist abgelaufen. Bitten Sie die Person, das Konto in AdaptlyPost neu zu verbinden. Nicht erneut versuchen
`inbox_reply_invalid`	400	Der Text ist leer oder zu lang. Die Meldung nennt das Limit. Text korrigieren
`inbox_messaging_window_closed`	400	Facebook oder Instagram: Das 24-Stunden-Antwortfenster ist abgelaufen. Abbrechen
`inbox_rate_limited`	429	Die Plattform hat AdaptlyPost gedrosselt. Nach einer Weile erneut versuchen
`inbox_platform_error`	503	Die Plattform ist fehlgeschlagen. Später erneut versuchen
`permission_denied`	403	Der Rolle des Schlüssels fehlt inbox.read oder inbox.reply. Nicht erneut versuchen
`subscription_required`	403	Ein Schreibzugriff ohne aktiven AdaptlyPost-Tarif. Nicht erneut versuchen

Ungelesene Kommentare auflisten

curl --request GET \
  --url 'https://post.adaptlypost.com/post/api/v1/inbox/comments?statuses=UNREAD&platforms=INSTAGRAM,FACEBOOK&limit=25' \
  --header 'Authorization: Bearer <api-key>'

Einen Kommentarverlauf lesen

curl --request GET \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40 \
  --header 'Authorization: Bearer <api-key>'

200
{
  "comment": { "id": "cmt_8f2a1c40", "isReply": false, "...": "..." },
  "parent": null,
  "replies": [
    { "id": "cmt_9b31d7e2", "isReply": true, "isOwn": true, "...": "..." }
  ]
}

Auf einen Kommentar antworten

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40/reply \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "text": "Thanks Ana, the new plan starts on Monday." }'

Einen Kommentar ausblenden, liken oder löschen

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40/hide \
  --header 'Authorization: Bearer <api-key>'

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40/like \
  --header 'Authorization: Bearer <api-key>'

curl --request DELETE \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/cmt_8f2a1c40 \
  --header 'Authorization: Bearer <api-key>'

Kommentare als erledigt markieren

curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/inbox/comments/status \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{ "ids": ["cmt_8f2a1c40", "cmt_7c02e9a1"], "status": "DONE" }'

200

{
  "comments": [
    {
      "id": "cmt_8f2a1c40",
      "accountId": "conn_ig_001",
      "platform": "INSTAGRAM",
      "accountName": "adaptlypost",
      "postId": "cmm0z0k3q0000i0r5mxn0hfhs",
      "platformPostId": "18034417852490123",
      "postText": "Plan a week of posts in one sitting",
      "postPermalink": "https://www.instagram.com/p/C9x2Lm0tQ1a/",
      "platformCommentId": "17890455123456789",
      "parentPlatformCommentId": null,
      "isReply": false,
      "author": {
        "id": "17841400000000001",
        "name": "Ana Souza",
        "username": "ana.souza",
        "avatarUrl": null
      },
      "text": "Does this work with Reels too?",
      "permalink": null,
      "likeCount": 2,
      "createdAt": "2026-11-08T09:12:44.000Z",
      "status": "UNREAD",
      "isHidden": false,
      "isOwn": false,
      "replied": false,
      "repliedAt": null,
      "likedByAccount": false,
      "capabilities": {
        "canReply": true,
        "canHide": true,
        "canDelete": true,
        "canLike": false
      }
    }
  ],
  "total": 12,
  "hasMore": false,
  "nextCursor": null
}