Comments API 概觀 - Ayrshare API Documentation

Comments 端點讓你的使用者能對其貼文發布、回覆、取得與刪除留言。共有四種留言 ID 類型：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 發布貼文，可在單一呼叫中傳送到多個社群網路。回傳的最外層即為 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，也就是社群網路指派的 post ID。

若該貼文是透過 Ayrshare 發布，請改用 Ayrshare Post ID。

例如：

取得貼文歷史

首先透過取得全部貼文歷史端點，取得非透過 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/"
        },
    ]
}

社群 post id 也會回傳在 post 端點的 postIds 欄位中。

取得貼文的留言

使用取得的 id、將 searchPlatformId 設為 true、並將 platform 設為 instagram，取得該 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 Comment ID 管理透過 Ayrshare 發布的貼文之留言。 Ayrshare comment ID 是由 Ayrshare 指派的留言 ID，可在發布留言的回應中的 commentId 欄位找到。若你想取得某則透過 Ayrshare 發布之留言的詳情，通常會使用此 ID。使用 Social Comment ID 管理非透過 Ayrshare 發布的貼文之留言。 Social comment ID 是來自社群網路的 comment ID（而非 Ayrshare ID），可在取得留言的回應中的 commentId 欄位找到。

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

若你想取得某則非透過 Ayrshare 發布之留言的詳情（例如 LinkedIn 對留言的回覆），通常會使用此 ID。

停用留言

發布貼文時可透過 /post 端點的 disableComments 欄位停用留言。留言僅會在 Instagram、LinkedIn 與 TikTok 上被停用。你也可以在已發布的貼文上，透過更新貼文端點與 disableComments 欄位，啟用或停用留言。

平台限制

TikTok — DELETE /comments 僅限自己撰寫的留言。 DELETE /comments 在 TikTok 上僅對已認證 TikTok 帳號本身所撰寫的留言（即你自己的回覆）成功。嘗試刪除其他使用者所撰寫的留言會回傳 Ayrshare code: 328。若你需要審核自己 TikTok 影片下的第三方留言，請聯絡支援，讓我們確認你所連結的帳號類型上有哪些可用選項。

​留言 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 管理留言

停用留言

平台限制