Vue d'ensemble de l'API Comments - Ayrshare API Documentation

Les points de terminaison Comments permettent à vos utilisateurs de publier, répondre, récupérer et supprimer des commentaires sur leurs publications. Il existe quatre types d’identifiants de commentaires : l’ID de publication Ayrshare, l’ID de publication social, l’ID de commentaire Ayrshare et l’ID de commentaire social. Chacun de ces identifiants sert à des fins différentes.

Types d’identifiants de commentaires

Commentaires avec l’ID de publication Ayrshare

Le flux typique est le suivant : lorsque vous publiez via Ayrshare, vous obtenez l’ID de publication Ayrshare. Vous pouvez ensuite utiliser cet ID de publication Ayrshare pour gérer les commentaires sur cette publication. Plateformes prises en charge : Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter et YouTube. Par exemple :

Publier une publication

Utilisez le point de terminaison /post pour publier via Ayrshare, ce qui peut envoyer vers plusieurs réseaux sociaux en un seul appel.Dans le retour se trouve l’ID de publication Ayrshare de premier niveau.

{
    "status": "success",
    "errors": [],
    "postIds": [
    {
        "status": "success",
        "id": "106638148652329_591370753547555",
        "postUrl": "https://www.facebook.com/106638148652329/posts/591370753547555",
        "platform": "facebook"
    }
    ],
    "id": "E4UdUr1yRbvI7qqCSlaq", // Ayrshare Post ID
    "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc055",
    "post": "What an amazing day",
    "validate": true
}

Publier un commentaire

Utilisez le point de terminaison /comments pour publier un commentaire avec l’ID de publication Ayrshare. Le commentaire sera automatiquement publié sur chaque réseau social où la publication d’origine a été publiée. Par exemple, si vous avez publié sur Facebook et Instagram, le commentaire apparaîtra sur les deux plateformes.

POST https://api.ayrshare.com/api/comments/:id

Obtenir les commentaires

Utilisez le point de terminaison /comments pour obtenir les commentaires de la publication à partir de l’ID de publication Ayrshare. Cela renverra tous les commentaires de chaque réseau social où la publication a été publiée. Par exemple, si vous avez publié sur Facebook et Instagram, vous obtiendrez les commentaires des deux plateformes.

GET https://api.ayrshare.com/api/comments/:id

Parfois, vous pouvez vouloir gérer les commentaires sur une publication qui n’a pas été publiée via Ayrshare. Dans ce cas, vous pouvez utiliser l’ID de publication social, qui est l’ID de publication attribué par le réseau social.

Si la publication a été publiée via Ayrshare, utilisez l’ID de publication Ayrshare.

Par exemple :

Obtenir l'historique des publications

Commencez par obtenir les publications Instagram publiées en dehors d’Ayrshare avec le point de terminaison Get All Post History.Le point de terminaison retourne une liste de publications avec l’id social de la publication.

{
    "status": "success",
    "posts": [
        {
            "mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/7531.jpg",
            "permalink": "https://www.instagram.com/p/B5OBT3ygpfg/",
            "commentsCount": 0,
            "created": "2022-05-20T17:26:03Z",
            "likeCount": 0,
            "mediaProductType": "FEED",
            "mediaType": "IMAGE",
            "username": "thegoodone",
            "id": "17833140557332933", // Instagram Social Post ID
            "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51..jpg",
            "post": "The #Mandalorian is on tonight instead of Friday",
            "postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/"
        },
    ]
}

L’id social de la publication est également renvoyé dans le champ postIds du point de terminaison post.

Obtenir les commentaires d'une publication

Utilisez l’id retourné pour obtenir tous les commentaires d’une publication Instagram spécifique en utilisant l’id social, searchPlatformId défini sur true et platform défini sur instagram.

GET https://api.ayrshare.com/api/comments/17833140557332933?platform=instagram&searchPlatformId=true

Utiliser l'ID de commentaire pour obtenir les détails du commentaire

Le JSON retourné à l’étape précédente contiendra un commentId pour chaque commentaire, qui est l’ID de commentaire social.

{
    "instagram": [
        {
            "comment": "What an amazing comment",
            "commentId": "17969247335804735", // Social Comment ID
            "created": "2024-11-26T11:49:00Z",
            "from": {
            "id": "103038435208332",
            "username": "john_smith"
            },
            "hidden": false,
            "likeCount": 3,
            "platform": "instagram",
            "postId": "18231730279304333",
            "username": "john_smith"
        }
    ]
}

Commentaires avec un ID de commentaire Ayrshare

Gérez les commentaires d’une publication qui ont été publiés via Ayrshare en utilisant l’ID de commentaire Ayrshare. L’ID de commentaire Ayrshare est l’ID de commentaire attribué par Ayrshare et se trouve dans le champ commentId de la réponse lors de la publication d’un commentaire. Il est souvent utilisé pour obtenir des détails sur un commentaire particulier publié via Ayrshare. Gérez les commentaires d’une publication qui n’ont pas été publiés via Ayrshare en utilisant l’ID de commentaire social. L’ID de commentaire social est l’ID de commentaire du réseau social, et non l’ID Ayrshare, et se trouve dans le champ commentId de la réponse lors de la récupération des commentaires.

GET https://api.ayrshare.com/api/comments/17969247335804735?platform=instagram&searchPlatformId=true&commentId=true

Il est souvent utilisé pour obtenir des détails sur un commentaire particulier publié en dehors d’Ayrshare, comme les réponses LinkedIn à des commentaires.

Désactiver les commentaires

Vous pouvez désactiver les commentaires lors de la publication d’un post en utilisant le champ disableComments du point de terminaison /post. Les commentaires ne seront désactivés que pour Instagram, LinkedIn et TikTok. Vous pouvez également activer ou désactiver les commentaires sur une publication déjà publiée en utilisant le point de terminaison update post et le champ disableComments.

Limitations des plateformes

TikTok — DELETE /comments uniquement pour les commentaires que vous avez rédigés. DELETE /comments sur TikTok ne réussit que pour les commentaires rédigés par le compte TikTok authentifié lui-même (vos propres réponses). Toute tentative de suppression d’un commentaire rédigé par un autre utilisateur retourne le code Ayrshare 328. Pour la modération des commentaires tiers sur vos propres vidéos TikTok, contactez le support pour que nous puissions confirmer ce qui est disponible pour votre type de compte lié.

​Types d’identifiants de commentaires

​Commentaires avec l’ID de publication Ayrshare

​Commentaires avec un ID de publication social

​Commentaires avec un ID de commentaire Ayrshare

​Commentaires avec un ID de commentaire social

​Désactiver les commentaires

​Limitations des plateformes

Types d’identifiants de commentaires

Commentaires avec l’ID de publication Ayrshare

Commentaires avec un ID de publication social

Commentaires avec un ID de commentaire Ayrshare

Commentaires avec un ID de commentaire social

Désactiver les commentaires

Limitations des plateformes