{
// 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"
}
}
Analytics
Social ID द्वारा पोस्ट पर Analytics
Social Post ID का उपयोग करके पोस्ट के लिए real-time analytics प्राप्त करें
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: trueparameter शामिल करें कि आप 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 आवश्यक है।array
एक ही request में कई पोस्ट पर analytics प्राप्त करने के लिए Social Post IDs का Array। अधिकतम 100 IDs की अनुमति है। या तो
id या postIds आवश्यक है।{
"postIds": ["1979851549871354062", "2011793803951137234"]
}
array
आवश्यक
analytics प्राप्त करने के लिए platforms का String array। केवल एक मान की अनुमति है।उपलब्ध मान:
{
"platforms": ["facebook", "instagram", "linkedin", "threads",
"tiktok", "twitter", "youtube"]
}
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 हुआ था।
{
/**
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"
}
}
⌘I