Огляд Comments API

Ендпоінти Comments дозволяють вашим користувачам публікувати, відповідати, отримувати та видаляти коментарі до своїх постів. Існує чотири типи ідентифікаторів коментарів: Ayrshare Post ID, Social Post ID, Ayrshare Comment ID та Social Comment ID. Кожен із цих ідентифікаторів використовується для різних цілей.

Типи Comment ID

Коментарі з Ayrshare Post ID

Типовий сценарій: коли ви публікуєте пост через Ayrshare, ви отримуєте Ayrshare Post ID. Далі цей Ayrshare Post ID можна використовувати для керування коментарями до цього посту. Підтримувані платформи: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter та YouTube. Наприклад:

Опублікуйте пост

Використайте ендпоінт /post для публікації посту через Ayrshare — його можна надіслати в кілька соцмереж одним викликом.У відповіді на верхньому рівні повертається Ayrshare Post ID.

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

Опублікуйте коментар

Використайте ендпоінт /comments, щоб опублікувати коментар за Ayrshare Post ID. Коментар автоматично публікуватиметься в усіх соцмережах, де було опубліковано оригінальний пост. Наприклад, якщо ви опублікували пост у Facebook та Instagram, коментар з’явиться на обох платформах.

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

Отримайте коментарі

Використайте ендпоінт /comments, щоб отримати коментарі до посту за Ayrshare Post ID. Буде повернуто всі коментарі з усіх соцмереж, де було опубліковано пост. Наприклад, якщо ви публікували у Facebook та Instagram, ви отримаєте коментарі з обох платформ.

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

Іноді може виникнути потреба керувати коментарями до посту, який не було опубліковано через Ayrshare. У такому разі використовуйте Social Post ID — ID посту, присвоєний соцмережею.

Якщо пост було опубліковано через Ayrshare, використовуйте Ayrshare Post ID.

Наприклад:

Отримайте історію постів

Спочатку отримайте пости Instagram, опубліковані поза межами Ayrshare, за допомогою ендпоінта Get All Post History.Ендпоінт повертає список постів із соціальним id посту.

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

Соціальний id посту також повертається у полі postIds ендпоінта post.

Отримайте коментарі до посту

Використайте повернутий id, щоб отримати всі коментарі для конкретного посту Instagram, вказавши соціальний id, searchPlatformId як true та platform як instagram.

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

Використайте Comment ID для отримання деталей коментаря

Повернутий JSON із попереднього кроку матиме commentId для кожного коментаря — це 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"
        }
    ]
}

Коментарі з Ayrshare Comment ID

Керуйте коментарями до посту, опублікованого через Ayrshare, за допомогою Ayrshare Comment ID. Ayrshare comment ID — це ID коментаря, присвоєний Ayrshare, який можна знайти в полі commentId у відповіді під час публікації коментаря. Часто використовується, якщо потрібно отримати деталі конкретного коментаря, опублікованого через Ayrshare. Керуйте коментарями до посту, який не було опубліковано через Ayrshare, за допомогою Social Comment ID. Social comment ID — це ID коментаря із соцмережі, а не Ayrshare ID; його можна знайти в полі commentId у відповіді під час отримання коментарів.

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

Часто використовується для отримання деталей конкретного коментаря, опублікованого поза межами Ayrshare, — наприклад, відповідей на коментарі в LinkedIn.

Вимкнення коментарів

Ви можете вимкнути коментарі під час публікації посту за допомогою поля disableComments в ендпоінті /post. Коментарі будуть вимкнені лише для Instagram, LinkedIn та TikTok. Ви також можете увімкнути або вимкнути коментарі до вже опублікованого посту за допомогою ендпоінта update post та поля disableComments.

Обмеження платформ

TikTok — DELETE /comments лише для власних коментарів. DELETE /comments у TikTok успішно виконується лише для коментарів, автором яких є сам автентифікований TikTok-акаунт (ваші власні відповіді). Спроба видалити коментар іншого користувача повертає Ayrshare code: 328. Для модерації сторонніх коментарів під вашими TikTok-відео зверніться до підтримки, щоб ми уточнили, що доступно для вашого типу підключеного акаунта.

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Типи Comment ID

Коментарі з Ayrshare Post ID

Коментарі з Ayrshare Comment ID

Вимкнення коментарів

Обмеження платформ

​Типи Comment ID

​Коментарі з Ayrshare Post ID

​Коментарі із Social Post ID

​Коментарі з Ayrshare Comment ID

​Коментарі із Social Comment ID

​Вимкнення коментарів

​Обмеження платформ

Типи Comment ID

Коментарі з Ayrshare Post ID

Коментарі із Social Post ID

Коментарі з Ayrshare Comment ID

Коментарі із Social Comment ID

Вимкнення коментарів

Обмеження платформ