Visão geral da Comments API - Ayrshare API Documentation

Os endpoints de Comments permitem que seus usuários publiquem, respondam, obtenham e excluam comentários em suas publicações. Existem quatro tipos de IDs de comentários: Ayrshare Post ID, Social Post ID, Ayrshare Comment ID e Social Comment ID. Cada um desses IDs é usado para propósitos diferentes.

Tipos de ID de comentário

Comentários com Ayrshare Post ID

O fluxo típico é: quando você publica uma publicação via Ayrshare, recebe o Ayrshare Post ID. Você pode então usar esse Ayrshare Post ID para gerenciar comentários nessa publicação. Plataformas suportadas: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter e YouTube. Por exemplo:

Publicar uma publicação

Use o endpoint /post para publicar uma publicação via Ayrshare, que pode ser enviada para várias redes sociais em uma única chamada.No retorno está o Ayrshare Post ID de nível superior.

{
    "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
}

Publicar um comentário

Use o endpoint /comments para publicar um comentário usando o Ayrshare Post ID. O comentário será publicado automaticamente em todas as redes sociais onde a publicação original foi publicada. Por exemplo, se você publicou no Facebook e no Instagram, o comentário aparecerá em ambas as plataformas.

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

Obter comentários

Use o endpoint /comments para obter os comentários da publicação com o Ayrshare Post ID. Isso retornará todos os comentários de todas as redes sociais onde a publicação foi publicada. Por exemplo, se você publicou no Facebook e no Instagram, obterá comentários de ambas as plataformas.

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

Às vezes você pode querer gerenciar comentários em uma publicação que não foi publicada via Ayrshare. Nesse caso, você pode usar o Social Post ID, que é o ID da publicação atribuído pela rede social.

Se a publicação foi publicada via Ayrshare, use o Ayrshare Post ID.

Por exemplo:

Obter histórico de publicações

Comece obtendo as publicações do Instagram publicadas fora do Ayrshare com o endpoint Get All Post History.O endpoint retorna uma lista de publicações com o id social da publicação.

{
    "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/"
        },
    ]
}

O id da publicação social também é retornado no campo postIds do endpoint post.

Obter comentários de uma publicação

Use o id retornado para obter todos os comentários de uma publicação específica do Instagram usando o id social, searchPlatformId definido como true e platform definido como instagram.

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

Use o Comment ID para obter detalhes do comentário

O JSON retornado da etapa anterior terá um commentId para cada comentário, que é o social comment ID.

{
    "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"
        }
    ]
}

Comentários com Ayrshare Comment ID

Gerencie comentários em uma publicação que foi publicada via Ayrshare usando o Ayrshare Comment ID. O Ayrshare comment ID é o ID do comentário atribuído pelo Ayrshare e pode ser encontrado no campo commentId na resposta ao publicar um comentário. Isso é frequentemente usado quando você quer obter detalhes sobre um comentário específico publicado via Ayrshare. Gerencie comentários em uma publicação que não foi publicada via Ayrshare usando o Social Comment ID. O social comment ID é o ID do comentário da rede social, não o ID do Ayrshare, e pode ser encontrado no campo commentId na resposta ao obter comentários.

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

Isso é frequentemente usado quando você quer obter detalhes sobre um comentário específico publicado fora do Ayrshare, como respostas do LinkedIn a comentários.

Desabilitar comentários

Você pode desabilitar comentários ao publicar uma publicação usando o campo disableComments no endpoint /post. Os comentários serão desabilitados apenas para Instagram, LinkedIn e TikTok. Você também pode habilitar ou desabilitar comentários em uma publicação já publicada usando o endpoint update post e o campo disableComments.

Limitações de plataforma

TikTok — DELETE /comments é apenas para autoria própria. DELETE /comments no TikTok só funciona para comentários criados pela própria conta autenticada do TikTok (suas próprias respostas). Tentar excluir um comentário criado por outro usuário retorna Ayrshare code: 328. Para moderação de comentários de terceiros nos seus próprios vídeos do TikTok, entre em contato com o suporte para confirmarmos o que está disponível para o seu tipo de conta vinculada.

​Tipos de ID de comentário

​Comentários com Ayrshare Post ID

​Comentários com Social Post ID

​Comentários com Ayrshare Comment ID

​Comentários com Social Comment ID

​Desabilitar comentários

​Limitações de plataforma

Tipos de ID de comentário

Comentários com Ayrshare Post ID

Comentários com Social Post ID

Comentários com Ayrshare Comment ID

Comentários com Social Comment ID

Desabilitar comentários

Limitações de plataforma