Commentaires

Lisez les commentaires d'une Page Facebook ou d'un compte Instagram connecté, répondez-y au nom du compte et masquez ceux qui n'ont pas leur place. Les publications faites hors de Kreatoai sont comprises. Les autres réseaux ne sont pas pris en charge.

Principe

GET

/v1/accounts/:id/comments

Lire les commentaires du compte

POST

/v1/accounts/:id/comments/:commentId/replies

Répondre au nom du compte

PATCH

/v1/accounts/:id/comments/:commentId

Masquer ou réafficher un commentaire

:id est l'identifiant du compte renvoyé par /v1/accounts. Lire demande le scope accounts:read ou publish:posts ; répondre et masquer demandent publish:posts. Une réponse ne compte pas parmi les publications offertes de la formule gratuite.

Un compte relié avant le 27 octobre 2026 n'a pas encore le droit de gérer ses commentaires : renouvelez son accès une fois depuis la page Comptes connectés du tableau de bord (bouton Renouveler), en gardant cochées toutes vos Pages.

Lire les commentaires

Paramètre	Description
`postId`	Une publication précise : son identifiant Kreatoai (celui de /v1/posts) ou celui du réseau (postId d'une réponse précédente). Absent : les dernières publications commentées du compte
`posts`	Sans postId, combien de publications commentées lire : 3 par défaut, 10 au plus
`limit`	Commentaires de premier niveau lus par publication, du plus récent au plus ancien : 25 par défaut, 50 au plus

curl "https://api.kreatoai.com/v1/accounts/a3f27c9e-4b12-4c8d-9f01-7d2e5b8a1c34/comments?posts=3" \
  -H "x-api-key: sk-kre-v1-votre_cle"

// 200 OK
{
  "account": { "id": "a3f27c9e-…", "platform": "facebook", "name": "Campus Plus" },
  "posts": [
    {
      "postId": "1218503388022361_122119972095463744",
      "url": "https://www.facebook.com/…/posts/122119972095463744",
      "caption": "Les inscriptions de la rentrée sont ouvertes…",
      "publishedAt": "2026-10-14T09:23:03.000Z",
      "commentCount": 2,
      "comments": [
        {
          "id": "122119972095463744_955475063842047",
          "author": "Awa Diallo",
          "text": "Il reste des places en septembre ?",
          "createdAt": "2026-10-14T10:02:41.000Z",
          "likeCount": 1,
          "hidden": false,
          "byAccount": false,
          "answered": true,
          "replies": [
            {
              "id": "122119972095463744_955512338100912",
              "author": "Campus Plus",
              "text": "Oui, encore une dizaine. Écrivez-nous en message privé.",
              "createdAt": "2026-10-14T10:20:05.000Z",
              "likeCount": 0,
              "hidden": false,
              "byAccount": true
            }
          ]
        }
      ]
    }
  ]
}

Champ	Description
`author`	Nom affiché de l'auteur sur Facebook, nom d'utilisateur sur Instagram
`byAccount`	Écrit par le compte lui-même (la Page, le profil Instagram)
`answered`	Le compte a déjà répondu sous ce commentaire
`hidden`	Commentaire masqué aux autres visiteurs
`commentCount`	Total donné par le réseau, réponses comprises : il peut dépasser ce qui est rendu (commentaires de comptes restreints, supprimés)

Répondre

curl -X POST https://api.kreatoai.com/v1/accounts/a3f27c9e-4b12-4c8d-9f01-7d2e5b8a1c34/comments/122119972095463744_955475063842047/replies \
  -H "x-api-key: sk-kre-v1-votre_cle" \
  -H "Content-Type: application/json" \
  -d '{ "message": "Merci ! Le lien est dans notre bio." }'

// 201 Created
{ "id": "122119972095463744_955512338100912", "replyTo": "122119972095463744_955475063842047", "platform": "facebook" }

La réponse est publiée tout de suite, au nom du compte, et visible de tous. 8 000 caractères au plus sur Facebook, 2 200 sur Instagram. Sur Instagram, une réponse à une réponse se range sous le commentaire de départ, et un commentaire masqué ne reçoit pas de réponse.

Masquer ou réafficher

curl -X PATCH https://api.kreatoai.com/v1/accounts/a3f27c9e-4b12-4c8d-9f01-7d2e5b8a1c34/comments/18129222787890663 \
  -H "x-api-key: sk-kre-v1-votre_cle" \
  -H "Content-Type: application/json" \
  -d '{ "hidden": true }'

Masqué, un commentaire n'est plus montré aux autres visiteurs, mais son auteur le voit toujours. { "hidden": false } le réaffiche. Les commentaires du compte lui-même ne se masquent pas.

Erreurs

Code	Signification
`comments_unsupported_platform`	Le compte n'est ni une Page Facebook ni un compte Instagram
`comments_permission_missing`	Le compte n'a pas le droit de gérer ses commentaires : renouvelez son accès. Pour un Instagram relié par une Page Facebook gérée dans un portefeuille business, reliez-le plutôt directement par Instagram
`comment_not_found`	Le commentaire n'existe pas, a été supprimé, ou n'est pas sous une publication de ce compte. Rien n'est envoyé
`post_not_found`	La publication n'est pas sur ce compte, ou n'est pas encore partie
`comment_too_long`	Réponse au delà de la limite du réseau
`channel_needs_reauth`	L'accès au compte a expiré : renouvelez-le