Comments API 概要

Comments エンドポイントを使用すると、ユーザーは自身の投稿に対してコメントの投稿、返信、取得、削除を行えます。コメント ID には 4 種類あります: Ayrshare Post ID、Social Post ID、Ayrshare Comment ID、Social Comment ID。それぞれの ID は目的に応じて使い分けます。

コメント ID の種類

Ayrshare Post ID を使用したコメント

一般的なフローは、Ayrshare 経由で投稿を公開すると Ayrshare Post ID が返される、というものです。この Ayrshare Post ID を使って、その投稿へのコメントを管理できます。対応プラットフォーム: Bluesky、Facebook Pages、Instagram、LinkedIn、Reddit、Threads、TikTok、Twitter、YouTube。例：

投稿を公開

/post エンドポイントで Ayrshare 経由で投稿を公開します。1 回の呼び出しで複数のソーシャルネットワークに送信できます。レスポンスのトップレベルに 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 を使用してください。

例：

投稿履歴を取得

まず、Get All Post History エンドポイントを使って、Ayrshare 経由以外で公開された Instagram 投稿を取得します。エンドポイントは投稿のソーシャル 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 は post エンドポイントの postIds フィールドでも返されます。

投稿のコメントを取得

返された id を使い、ソーシャル id、searchPlatformId を true、platform を instagram に設定して、特定の Instagram 投稿のすべてのコメントを取得します。

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

コメント ID を使ってコメント詳細を取得

前の手順で返される JSON には、各コメントの Social Comment ID である commentId が含まれます。

{
    "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 は Ayrshare から割り当てられたコメント ID で、コメント投稿レスポンスの 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

これは、LinkedIn でのコメントへの返信のように、Ayrshare 外で公開された特定のコメントの詳細を取得したい場合によく使われます。

コメントの無効化

/post エンドポイントの disableComments フィールドを使って、投稿公開時にコメントを無効化できます。コメントが無効化されるのは Instagram、LinkedIn、TikTok のみです。すでに公開された投稿については、update post エンドポイントと disableComments フィールドを使って、コメントの有効化・無効化を切り替えることもできます。

プラットフォーム制限

TikTok — DELETE /comments は自作コメントのみ。 TikTok の DELETE /comments は、認証済み TikTok アカウント自身が投稿したコメント（自身の返信）に対してのみ成功します。他のユーザーが投稿したコメントを削除しようとすると Ayrshare code: 328 が返されます。自身の TikTok 動画上の第三者コメントを管理する必要がある場合は、連携アカウントタイプで何が利用可能かをサポートで確認してください。

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

コメント ID の種類

Ayrshare Post ID を使用したコメント

Ayrshare Comment ID を使用したコメント

コメントの無効化

プラットフォーム制限

​コメント ID の種類

​Ayrshare Post ID を使用したコメント

​Social Post ID を使用したコメント

​Ayrshare Comment ID を使用したコメント

​Social Comment ID を使用したコメント

​コメントの無効化

​プラットフォーム制限

コメント ID の種類

Ayrshare Post ID を使用したコメント

Social Post ID を使用したコメント

Ayrshare Comment ID を使用したコメント

Social Comment ID を使用したコメント

コメントの無効化

プラットフォーム制限