Visión general de la API de Comentarios - Ayrshare API Documentation

Los endpoints de Comentarios permiten a tus usuarios publicar, responder, obtener y eliminar comentarios en sus publicaciones. Hay cuatro tipos de IDs de comentarios: ID de publicación de Ayrshare, ID de publicación social, ID de comentario de Ayrshare e ID de comentario social. Cada uno de estos IDs se usa con fines diferentes.

Tipos de ID de comentario

Comentarios con ID de publicación de Ayrshare

El flujo típico es: cuando publicas una publicación mediante Ayrshare, obtienes el ID de publicación de Ayrshare. Luego puedes usar este ID de publicación de Ayrshare para administrar los comentarios en esa publicación. Plataformas admitidas: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter y YouTube. Por ejemplo:

Publicar una publicación

Usa el endpoint /post para publicar una publicación mediante Ayrshare, que puede enviarse a varias redes sociales en una sola llamada.En la respuesta se incluye el ID de publicación de Ayrshare de nivel 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 un comentario

Usa el endpoint /comments para publicar un comentario con el ID de publicación de Ayrshare. El comentario se publicará automáticamente en todas las redes sociales donde se publicó la publicación original. Por ejemplo, si publicaste en Facebook e Instagram, el comentario aparecerá en ambas plataformas.

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

Obtener comentarios

Usa el endpoint /comments para obtener los comentarios de la publicación con el ID de publicación de Ayrshare. Esto devolverá todos los comentarios de cada red social donde se publicó la publicación. Por ejemplo, si publicaste en Facebook e Instagram, obtendrás comentarios de ambas plataformas.

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

A veces puedes querer administrar comentarios de una publicación que no se publicó mediante Ayrshare. En este caso puedes usar el ID de publicación social, que es el ID de publicación asignado por la red social.

Si la publicación se publicó mediante Ayrshare, usa el ID de publicación de Ayrshare.

Por ejemplo:

Obtener el historial de publicaciones

Comienza obteniendo las publicaciones de Instagram publicadas fuera de Ayrshare con el endpoint Get All Post History.El endpoint devuelve una lista de publicaciones con el id social de la publicación.

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

El id de publicación social también se devuelve en el campo postIds del endpoint post.

Obtener comentarios de una publicación

Usa el id devuelto para obtener todos los comentarios de una publicación específica de Instagram usando el id social, searchPlatformId establecido en true y platform establecido en instagram.

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

Usa el ID de comentario para obtener detalles del comentario

El JSON devuelto en el paso anterior tendrá un commentId para cada comentario, que es el ID de comentario 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"
        }
    ]
}

Comentarios con ID de comentario de Ayrshare

Administra comentarios en una publicación que fue publicada mediante Ayrshare usando el ID de comentario de Ayrshare. El ID de comentario de Ayrshare es el ID de comentario asignado por Ayrshare y se puede encontrar en el campo commentId en la respuesta al publicar un comentario. Se usa a menudo si deseas obtener detalles de un comentario en particular publicado mediante Ayrshare. Administra comentarios en una publicación que no fue publicada mediante Ayrshare usando el ID de comentario social. El ID de comentario social es el ID de comentario de la red social, no el ID de Ayrshare, y se puede encontrar en el campo commentId en la respuesta al obtener comentarios.

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

Se usa a menudo si deseas obtener detalles de un comentario en particular publicado fuera de Ayrshare, como las respuestas de LinkedIn a los comentarios.

Deshabilitar comentarios

Puedes deshabilitar los comentarios al publicar una publicación usando el campo disableComments en el endpoint /post. Los comentarios solo se deshabilitarán en Instagram, LinkedIn y TikTok. También puedes habilitar o deshabilitar comentarios en una publicación ya publicada usando el endpoint update post y el campo disableComments.

Limitaciones de la plataforma

TikTok — DELETE /comments es solo para comentarios propios. DELETE /comments en TikTok solo tiene éxito para comentarios creados por la propia cuenta autenticada de TikTok (tus propias respuestas). Intentar eliminar un comentario creado por otro usuario devuelve el code: 328 de Ayrshare. Para moderar comentarios de terceros en tus propios videos de TikTok, contacta a soporte para que confirmemos qué está disponible para tu tipo de cuenta vinculada.

​Tipos de ID de comentario

​Comentarios con ID de publicación de Ayrshare

​Comentarios con ID de publicación social

​Comentarios con ID de comentario de Ayrshare

​Comentarios con ID de comentario social

​Deshabilitar comentarios

​Limitaciones de la plataforma

Tipos de ID de comentario

Comentarios con ID de publicación de Ayrshare

Comentarios con ID de publicación social

Comentarios con ID de comentario de Ayrshare

Comentarios con ID de comentario social

Deshabilitar comentarios

Limitaciones de la plataforma