Phân tích Bài đăng theo Social ID - Ayrshare API Documentation

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "facebook"
    ],
    "searchPlatformId": true // Required
}

{
    // Array of Social Post IDs (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "twitter"
    ],
    "searchPlatformId": true // Required
}

{
  /**
    The response is the same as Analytics on a Post.
    Please see that endpoint for details.

    Note: Some metrics are not available for posts not owned by the authorized account.
    For example: X does not return non-public metrics or organic metrics for Tweets not sent by the authorized user.
  */
}

{
    "twitter": [
        {
            "id": "1313589441919827982",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "entities": {
                    "urls": [
                        {
                            "start": 77,
                            "end": 96,
                            "url": "https://t.co/abc123",
                            "expandedUrl": "https://www.ayrshare.com/docs",
                            "displayUrl": "ayrshare.com/docs",
                            "unwoundUrl": "https://www.ayrshare.com/docs"
                        }
                    ],
                    "hashtags": [
                        {
                            "start": 97,
                            "end": 112,
                            "tag": "SocialMediaAPI"
                        }
                    ],
                    "mentions": [
                        {
                            "start": 113,
                            "end": 122,
                            "username": "ayrshare"
                        }
                    ]
                },
                "name": "Wonder World",
                "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare",
                "publicMetrics": {
                    "retweetCount": 0,
                    "quoteCount": 0,
                    "likeCount": 0,
                    "replyCount": 0,
                    "bookmarkCount": 0,
                    "impressionCount": 23
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 1,
                    "engagements": 1,
                    "impressionCount": 5
                },
                "organicMetrics": {
                    "likeCount": 0,
                    "impressionCount": 5,
                    "replyCount": 0,
                    "retweetCount": 0,
                    "userProfileClicks": 1
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        },
        {
            "id": "1313589441919827999",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827999",
            "analytics": {
                "created": "2022-09-08T14:30:00.000Z",
                "name": "Wonder World",
                "post": "Another great day for social media automation!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 8,
                    "engagements": 12,
                    "impressionCount": 145
                },
                "organicMetrics": {
                    "likeCount": 15,
                    "impressionCount": 145,
                    "replyCount": 3,
                    "retweetCount": 5,
                    "userProfileClicks": 8
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "backfilledFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "recoveredFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "lastUpdated": "2023-12-08T03:40:31.185Z",
    "nextUpdate": "2023-12-08T03:51:31.185Z",
    "youtube": {
        "action": "post",
        "status": "error",
        "code": 186,
        "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent, the Profile Key is included if applicable, and the post at the social network has not been deleted. If you are trying to retrieve a post originating outside of Ayrshare, please use the /rest-api/endpoints/analytics#analytics-by-social-id",
        "id": "dtuu-jDp4381"
    }
}

POST

analytics

post

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "facebook"
    ],
    "searchPlatformId": true // Required
}

{
    // Array of Social Post IDs (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "twitter"
    ],
    "searchPlatformId": true // Required
}

{
  /**
    The response is the same as Analytics on a Post.
    Please see that endpoint for details.

    Note: Some metrics are not available for posts not owned by the authorized account.
    For example: X does not return non-public metrics or organic metrics for Tweets not sent by the authorized user.
  */
}

{
    "twitter": [
        {
            "id": "1313589441919827982",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "entities": {
                    "urls": [
                        {
                            "start": 77,
                            "end": 96,
                            "url": "https://t.co/abc123",
                            "expandedUrl": "https://www.ayrshare.com/docs",
                            "displayUrl": "ayrshare.com/docs",
                            "unwoundUrl": "https://www.ayrshare.com/docs"
                        }
                    ],
                    "hashtags": [
                        {
                            "start": 97,
                            "end": 112,
                            "tag": "SocialMediaAPI"
                        }
                    ],
                    "mentions": [
                        {
                            "start": 113,
                            "end": 122,
                            "username": "ayrshare"
                        }
                    ]
                },
                "name": "Wonder World",
                "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare",
                "publicMetrics": {
                    "retweetCount": 0,
                    "quoteCount": 0,
                    "likeCount": 0,
                    "replyCount": 0,
                    "bookmarkCount": 0,
                    "impressionCount": 23
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 1,
                    "engagements": 1,
                    "impressionCount": 5
                },
                "organicMetrics": {
                    "likeCount": 0,
                    "impressionCount": 5,
                    "replyCount": 0,
                    "retweetCount": 0,
                    "userProfileClicks": 1
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        },
        {
            "id": "1313589441919827999",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827999",
            "analytics": {
                "created": "2022-09-08T14:30:00.000Z",
                "name": "Wonder World",
                "post": "Another great day for social media automation!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 8,
                    "engagements": 12,
                    "impressionCount": 145
                },
                "organicMetrics": {
                    "likeCount": 15,
                    "impressionCount": 145,
                    "replyCount": 3,
                    "retweetCount": 5,
                    "userProfileClicks": 8
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "backfilledFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "recoveredFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "lastUpdated": "2023-12-08T03:40:31.185Z",
    "nextUpdate": "2023-12-08T03:51:31.185Z",
    "youtube": {
        "action": "post",
        "status": "error",
        "code": 186,
        "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent, the Profile Key is included if applicable, and the post at the social network has not been deleted. If you are trying to retrieve a post originating outside of Ayrshare, please use the /rest-api/endpoints/analytics#analytics-by-social-id",
        "id": "dtuu-jDp4381"
    }
}

Truy xuất dữ liệu phân tích cho các bài đăng không có nguồn gốc từ Ayrshare bằng cách cung cấp Social Post ID cấp thấp. ID này được trả về trong trường postIds của endpoint /post. Tài khoản được liên kết phải là chủ sở hữu của bài đăng để truy xuất dữ liệu phân tích (ngoại lệ: YouTube; xem bên dưới). Các nền tảng được hỗ trợ: Facebook, Instagram, LinkedIn, Threads, TikTok, Twitter, và YouTube.

Lệnh gọi giống với endpoint Phân tích một Bài đăng. Sự khác biệt chính là bạn sử dụng post id được trả về bởi mạng xã hội thay vì Ayrshare ID. Đồng thời hãy bao gồm tham số searchPlatformId: true để thông báo cho endpoint biết rằng bạn đang tìm kiếm theo Social Post ID.
Sử dụng endpoint Get All Post History để truy xuất các bài đăng và ID có nguồn gốc bên ngoài Ayrshare được tìm thấy trong trường id.
Chỉ khuyến nghị sử dụng cho các bài đăng không được gửi qua Ayrshare. Đối với các bài đăng được gửi qua Ayrshare, hãy sử dụng endpoint analytics.
Phân tích trên các bài đăng Instagram được xuất bản trước khi tài khoản của người dùng được chuyển đổi thành tài khoản doanh nghiệp từ tài khoản cá nhân sẽ có dữ liệu phân tích hạn chế.
Nếu truy xuất phân tích YouTube cho một bài đăng không thuộc kênh của bạn bằng phương thức social ID, API sẽ trả về metadata mô tả về nội dung trong khi hiển thị giá trị bằng 0 cho tất cả các chỉ số số học. Thông tin mô tả như tiêu đề, mô tả, thẻ, tiêu đề kênh, trạng thái riêng tư và URL hình thu nhỏ sẽ được điền đúng, cung cấp ngữ cảnh về nội dung video. Tuy nhiên, tất cả các chỉ số hiệu suất số học bao gồm lượt xem, lượt thích, bình luận, lượt chia sẻ, thay đổi người đăng ký, thời gian xem và các lần thêm vào playlist sẽ trả về giá trị bằng 0.
Khi sử dụng postIds cho các thread X/Twitter, Social Post ID của mỗi tweet phải được cung cấp riêng lẻ, các tweet trong thread không được tự động bao gồm khi truy vấn bài đăng gốc.

Tham số Body

Phải cung cấp id hoặc postIds. Sử dụng id cho một bài đăng đơn lẻ hoặc postIds để truy xuất dữ liệu phân tích cho nhiều bài đăng trong một yêu cầu duy nhất.

string

Social Post ID được trả về từ endpoint /post. Đây là trường id cho một mạng xã hội riêng lẻ được tìm thấy trong mảng postIds. Yêu cầu id hoặc postIds.

postIds

array

Mảng các Social Post ID để truy xuất dữ liệu phân tích cho nhiều bài đăng trong một yêu cầu duy nhất. Cho phép tối đa 100 ID. Yêu cầu id hoặc postIds.

{
  "postIds": ["1979851549871354062", "2011793803951137234"]
}

platforms

array

bắt buộc

Mảng chuỗi các nền tảng để truy xuất dữ liệu phân tích. Chỉ cho phép một giá trị.Các giá trị khả dụng:

{
  "platforms": ["facebook", "instagram", "linkedin", "threads",
                "tiktok", "twitter", "youtube"]
}

searchPlatformId

boolean

mặc định:false

bắt buộc

Đặt thành true để tìm kiếm theo Social Post ID.

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "facebook"
    ],
    "searchPlatformId": true // Required
}

{
    // Array of Social Post IDs (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // Select only one platform at a time:
      // facebook, instagram, youtube, threads, tiktok, or twitter
        "twitter"
    ],
    "searchPlatformId": true // Required
}

Khi các chỉ số tích lũy (ví dụ: lượt thích, bình luận, lượt xem) tạm thời không có sẵn từ mạng xã hội, API sẽ tự động điền bổ sung từ dữ liệu đã lưu trữ. Hai trường tùy chọn có thể xuất hiện trong đối tượng analytics theo từng nền tảng:

backfilledFrom (string, ISO 8601) — Xuất hiện khi một hoặc nhiều chỉ số tích lũy được thay thế từ dữ liệu đã lưu trữ. Timestamp cho biết khi nào dữ liệu đã lưu trữ được cập nhật lần cuối.
recoveredFrom (string, ISO 8601) — Xuất hiện khi toàn bộ phản hồi phân tích được khôi phục từ dữ liệu đã lưu trữ do lỗi API hoàn toàn. Timestamp cho biết khi nào dữ liệu đã lưu trữ được cập nhật lần cuối.

Dữ liệu đã lưu trữ cũ hơn 4 ngày được coi là lỗi thời và sẽ không được sử dụng để điền bổ sung hoặc khôi phục.

{
  /**
    The response is the same as Analytics on a Post.
    Please see that endpoint for details.

    Note: Some metrics are not available for posts not owned by the authorized account.
    For example: X does not return non-public metrics or organic metrics for Tweets not sent by the authorized user.
  */
}

{
    "twitter": [
        {
            "id": "1313589441919827982",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "entities": {
                    "urls": [
                        {
                            "start": 77,
                            "end": 96,
                            "url": "https://t.co/abc123",
                            "expandedUrl": "https://www.ayrshare.com/docs",
                            "displayUrl": "ayrshare.com/docs",
                            "unwoundUrl": "https://www.ayrshare.com/docs"
                        }
                    ],
                    "hashtags": [
                        {
                            "start": 97,
                            "end": 112,
                            "tag": "SocialMediaAPI"
                        }
                    ],
                    "mentions": [
                        {
                            "start": 113,
                            "end": 122,
                            "username": "ayrshare"
                        }
                    ]
                },
                "name": "Wonder World",
                "post": "Just launched our social media campaign using Ayrshare! Check out the API at https://t.co/abc123 #SocialMediaAPI @ayrshare",
                "publicMetrics": {
                    "retweetCount": 0,
                    "quoteCount": 0,
                    "likeCount": 0,
                    "replyCount": 0,
                    "bookmarkCount": 0,
                    "impressionCount": 23
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 1,
                    "engagements": 1,
                    "impressionCount": 5
                },
                "organicMetrics": {
                    "likeCount": 0,
                    "impressionCount": 5,
                    "replyCount": 0,
                    "retweetCount": 0,
                    "userProfileClicks": 1
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        },
        {
            "id": "1313589441919827999",    // Twitter Social Post ID
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827999",
            "analytics": {
                "created": "2022-09-08T14:30:00.000Z",
                "name": "Wonder World",
                "post": "Another great day for social media automation!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "nonPublicMetrics": {
                    "userProfileClicks": 8,
                    "engagements": 12,
                    "impressionCount": 145
                },
                "organicMetrics": {
                    "likeCount": 15,
                    "impressionCount": 145,
                    "replyCount": 3,
                    "retweetCount": 5,
                    "userProfileClicks": 8
                },
                "username": "wondrous"
            },
            "lastUpdated": "2022-04-23T18:44:29.778Z",
            "nextUpdate": "2022-04-23T19:19:29.778Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "backfilledFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "twitter": [
        {
            "id": "1313589441919827982",
            "postUrl": "https://www.twitter.com/myaccount/1313589441919827982",
            "analytics": {
                "created": "2022-09-07T22:12:10.000Z",
                "name": "Wonder World",
                "post": "Just launched our social media campaign!",
                "publicMetrics": {
                    "retweetCount": 5,
                    "quoteCount": 2,
                    "likeCount": 15,
                    "replyCount": 3,
                    "bookmarkCount": 1,
                    "impressionCount": 150
                },
                "username": "wondrous",
                "recoveredFrom": "2026-04-08T14:30:00.000Z"
            },
            "lastUpdated": "2026-04-09T10:15:00.000Z",
            "nextUpdate": "2026-04-09T10:26:00.000Z"
        }
    ],
    "status": "success",
    "code": 200
}

{
    "lastUpdated": "2023-12-08T03:40:31.185Z",
    "nextUpdate": "2023-12-08T03:51:31.185Z",
    "youtube": {
        "action": "post",
        "status": "error",
        "code": 186,
        "message": "Post ID not found. Please verify the top level ID returned from the /post endpoint is being sent, the Profile Key is included if applicable, and the post at the social network has not been deleted. If you are trying to retrieve a post originating outside of Ayrshare, please use the /rest-api/endpoints/analytics#analytics-by-social-id",
        "id": "dtuu-jDp4381"
    }
}

Phân tích một Bài đăng Phân tích một Mạng xã hội

⌘I

​Tham số Header

​Tham số Body

Tham số Header

Tham số Body