Social ID द्वारा पोस्ट पर Analytics

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // एक बार में केवल एक platform चुनें:
      // facebook, instagram, youtube, threads, tiktok, या twitter
        "facebook"
    ],
    "searchPlatformId": true // आवश्यक
}

{
    // Social Post IDs का Array (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // एक बार में केवल एक platform चुनें:
      // facebook, instagram, youtube, threads, tiktok, या twitter
        "twitter"
    ],
    "searchPlatformId": true // आवश्यक
}

{
  /**
    Response Analytics on a Post के समान है।
    विवरण के लिए कृपया वह endpoint देखें।

    नोट: authorized account के स्वामित्व वाले पोस्ट के अलावा कुछ metrics उपलब्ध नहीं हैं।
    उदाहरण के लिए: X, authorized user द्वारा नहीं भेजे गए Tweets के लिए non-public metrics या organic metrics नहीं लौटाता।
  */
}

{
    "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": [
      // एक बार में केवल एक platform चुनें:
      // facebook, instagram, youtube, threads, tiktok, या twitter
        "facebook"
    ],
    "searchPlatformId": true // आवश्यक
}

{
    // Social Post IDs का Array (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // एक बार में केवल एक platform चुनें:
      // facebook, instagram, youtube, threads, tiktok, या twitter
        "twitter"
    ],
    "searchPlatformId": true // आवश्यक
}

{
  /**
    Response Analytics on a Post के समान है।
    विवरण के लिए कृपया वह endpoint देखें।

    नोट: authorized account के स्वामित्व वाले पोस्ट के अलावा कुछ metrics उपलब्ध नहीं हैं।
    उदाहरण के लिए: X, authorized user द्वारा नहीं भेजे गए Tweets के लिए non-public metrics या organic metrics नहीं लौटाता।
  */
}

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

low-level Social Post ID प्रदान करके उन पोस्ट के लिए analytics प्राप्त करें जो Ayrshare के माध्यम से उत्पन्न नहीं हुए थे। यह ID /post endpoint के postIds फ़ील्ड में लौटाई जाती है। analytics प्राप्त करने के लिए linked account पोस्ट का स्वामी होना चाहिए (अपवाद: YouTube; नीचे देखें)। समर्थित platforms: Facebook, Instagram, LinkedIn, Threads, TikTok, Twitter, और YouTube।

यह call Analytics on a Post endpoint के समान है। मुख्य अंतर यह है कि आप Ayrshare ID के बजाय social network द्वारा लौटाई गई post id का उपयोग करते हैं। साथ ही endpoint को सूचित करने के लिए searchPlatformId: true parameter शामिल करें कि आप Social Post ID द्वारा खोज रहे हैं।
id फ़ील्ड में पाए गए Ayrshare के बाहर उत्पन्न पोस्ट और IDs को प्राप्त करने के लिए Get All Post History endpoint का उपयोग करें।
केवल उन पोस्ट के लिए उपयोग करने की सलाह है जो Ayrshare के माध्यम से नहीं भेजे गए। Ayrshare के माध्यम से भेजे गए पोस्ट के लिए, analytics endpoint का उपयोग करें।
Instagram पोस्ट पर analytics जो उपयोगकर्ता के account को personal से business account में परिवर्तित करने से पहले प्रकाशित किए गए थे, उनके पास सीमित analytics होते हैं।
यदि social id पद्धति का उपयोग करके किसी ऐसे पोस्ट के लिए YouTube analytics प्राप्त कर रहे हैं जो आपके channel का नहीं है, तो API सामग्री के बारे में descriptive metadata लौटाएगा जबकि सभी संख्यात्मक metrics के लिए zero दिखाएगा। descriptive जानकारी जैसे title, description, tags, channel title, privacy status, और thumbnail URLs सही ढंग से भरी जाएँगी, video सामग्री के बारे में context प्रदान करेंगी। हालाँकि, views, likes, comments, shares, subscriber परिवर्तन, watch time, और playlist additions सहित सभी संख्यात्मक performance metrics zero values के रूप में लौटेंगे।
X/Twitter threads के लिए postIds का उपयोग करते समय, प्रत्येक tweet की Social Post ID अलग से प्रदान की जानी चाहिए, thread tweets स्वचालित रूप से शामिल नहीं होते जब parent post के लिए query की जाती है।

Header Parameters

Body Parameters

या तो id या postIds प्रदान करना आवश्यक है। एकल पोस्ट के लिए id का उपयोग करें या एक ही request में कई पोस्ट पर analytics प्राप्त करने के लिए postIds का उपयोग करें।

string

/post endpoint से लौटाई गई Social Post ID। यह postIds array में पाए गए किसी व्यक्तिगत social network के लिए id फ़ील्ड है। या तो id या postIds आवश्यक है।

postIds

array

एक ही request में कई पोस्ट पर analytics प्राप्त करने के लिए Social Post IDs का Array। अधिकतम 100 IDs की अनुमति है। या तो id या postIds आवश्यक है।

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

platforms

array

आवश्यक

analytics प्राप्त करने के लिए platforms का String array। केवल एक मान की अनुमति है।उपलब्ध मान:

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

searchPlatformId

boolean

डिफ़ॉल्ट:false

आवश्यक

Social Post ID द्वारा खोजने के लिए true पर सेट करें।

{
    // Facebook Social Post ID
    "id": "104923907983682_108329000309742",
    "platforms": [
      // एक बार में केवल एक platform चुनें:
      // facebook, instagram, youtube, threads, tiktok, या twitter
        "facebook"
    ],
    "searchPlatformId": true // आवश्यक
}

{
    // Social Post IDs का Array (max 100)
    "postIds": ["1979851549871354062", "2011793803951137234"],
    "platforms": [
      // एक बार में केवल एक platform चुनें:
      // facebook, instagram, youtube, threads, tiktok, या twitter
        "twitter"
    ],
    "searchPlatformId": true // आवश्यक
}

जब cumulative metrics (उदा., likes, comments, views) social network से अस्थायी रूप से अनुपलब्ध हों, तो API स्वचालित रूप से stored data से उन्हें backfill करता है। प्रति-platform analytics object में दो वैकल्पिक फ़ील्ड दिखाई दे सकते हैं:

backfilledFrom (string, ISO 8601) — तब मौजूद जब एक या अधिक cumulative metrics को stored data से प्रतिस्थापित किया गया हो। timestamp इंगित करती है कि stored data कब अंतिम बार update हुआ था।
recoveredFrom (string, ISO 8601) — तब मौजूद जब पूरी analytics response को पूर्ण API failure के कारण stored data से recover किया गया हो। timestamp इंगित करती है कि stored data कब अंतिम बार update हुआ था।

4 दिन से पुराने stored data को stale माना जाता है और backfill या recovery के लिए उपयोग नहीं किया जाएगा।

{
  /**
    Response Analytics on a Post के समान है।
    विवरण के लिए कृपया वह endpoint देखें।

    नोट: authorized account के स्वामित्व वाले पोस्ट के अलावा कुछ metrics उपलब्ध नहीं हैं।
    उदाहरण के लिए: X, authorized user द्वारा नहीं भेजे गए Tweets के लिए non-public metrics या organic metrics नहीं लौटाता।
  */
}

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

पोस्ट पर एनालिटिक्स एक सोशल नेटवर्क पर Analytics

⌘I

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Social ID द्वारा पोस्ट पर Analytics

Header Parameters

Body Parameters

​Header Parameters

​Body Parameters

Header Parameters

Body Parameters