{
// Facebook Social Post ID
"id": "104923907983682_108329000309742",
"platforms": [
// Виберіть лише одну платформу за раз:
// facebook, instagram, youtube, threads, tiktok, або twitter
"facebook"
],
"searchPlatformId": true // Обов'язково
}
{
// Масив Social Post IDs (макс. 100)
"postIds": ["1979851549871354062", "2011793803951137234"],
"platforms": [
// Виберіть лише одну платформу за раз:
// facebook, instagram, youtube, threads, tiktok, або twitter
"twitter"
],
"searchPlatformId": true // Обов'язково
}
{
/**
Відповідь така сама, як і для Analytics on a Post.
Будь ласка, див. деталі на тій кінцевій точці.
Примітка: Деякі метрики недоступні для дописів, які не належать авторизованому обліковому запису.
Наприклад: X не повертає non-public metrics або organic metrics для Tweets, не надісланих авторизованим користувачем.
*/
}
{
"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
Отримати аналітику в реальному часі для дописів за допомогою Social Post ID
POST
/
analytics
/
post
{
// Facebook Social Post ID
"id": "104923907983682_108329000309742",
"platforms": [
// Виберіть лише одну платформу за раз:
// facebook, instagram, youtube, threads, tiktok, або twitter
"facebook"
],
"searchPlatformId": true // Обов'язково
}
{
// Масив Social Post IDs (макс. 100)
"postIds": ["1979851549871354062", "2011793803951137234"],
"platforms": [
// Виберіть лише одну платформу за раз:
// facebook, instagram, youtube, threads, tiktok, або twitter
"twitter"
],
"searchPlatformId": true // Обов'язково
}
{
/**
Відповідь така сама, як і для Analytics on a Post.
Будь ласка, див. деталі на тій кінцевій точці.
Примітка: Деякі метрики недоступні для дописів, які не належать авторизованому обліковому запису.
Наприклад: X не повертає non-public metrics або organic metrics для Tweets, не надісланих авторизованим користувачем.
*/
}
{
"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"
}
}
Отримайте аналітику для дописів, які не походять через Ayrshare, надавши низькорівневий Social Post ID.
Цей ID повертається в полі
postIds кінцевої точки /post.
Пов’язаний обліковий запис має бути власником допису для отримання аналітики (виняток: YouTube; див. нижче). Підтримувані платформи: Facebook, Instagram, LinkedIn, Threads, TikTok, Twitter та YouTube.
- Виклик такий самий, як і кінцева точка Analytics on a Post. Ключовою
відмінністю є те, що Ви використовуєте post id, повернутий соціальною мережею, замість Ayrshare ID. Також
включіть параметр
searchPlatformId: true, щоб повідомити кінцеву точку, що Ви шукаєте за Social Post ID. - Використовуйте кінцеву точку Get All Post History для отримання дописів та ID,
що походять за межами Ayrshare, знайдених у полі
id. - Рекомендується використовувати лише для дописів, не надісланих через Ayrshare. Для дописів, надісланих через Ayrshare, використовуйте кінцеву точку analytics.
- Аналітика дописів Instagram, опублікованих до перетворення облікового запису користувача з особистого на бізнес-обліковий запис, має обмежену аналітику.
- Якщо отримання аналітики YouTube для допису, який не належить Вашому каналу, за допомогою методу social id, API поверне описові метадані про контент, показуючи нулі для всіх числових метрик. Описова інформація, така як заголовок, опис, теги, назва каналу, статус конфіденційності та URL мініатюр буде правильно заповнена, надаючи контекст про відеоконтент. Однак усі числові показники продуктивності, включаючи перегляди, лайки, коментарі, поширення, зміни підписників, час перегляду та додавання в плейлисти, будуть повернуті як нульові значення.
- При використанні
postIdsдля потоків X/Twitter, Social Post ID кожного твіту має надаватися окремо, твіти потоку не включаються автоматично при запиті батьківського допису.
Параметри заголовка
Параметри тіла
Необхідно надати або
id, або postIds. Використовуйте id для одного допису або postIds для отримання аналітики кількох дописів в одному запиті.Social Post ID, повернений з кінцевої точки
/post. Це поле
id для окремої соціальної мережі, знайдене в
масиві postIds. Потрібен або id, або postIds.Масив Social Post IDs для отримання аналітики кількох дописів в одному запиті. Максимум 100 ID. Потрібен або
id, або postIds.{
"postIds": ["1979851549871354062", "2011793803951137234"]
}
Рядковий масив платформ для отримання аналітики. Дозволено лише одне значення.Доступні значення:
{
"platforms": ["facebook", "instagram", "linkedin", "threads",
"tiktok", "twitter", "youtube"]
}
Встановіть у
true, щоб шукати за Social Post ID.{
// Facebook Social Post ID
"id": "104923907983682_108329000309742",
"platforms": [
// Виберіть лише одну платформу за раз:
// facebook, instagram, youtube, threads, tiktok, або twitter
"facebook"
],
"searchPlatformId": true // Обов'язково
}
{
// Масив Social Post IDs (макс. 100)
"postIds": ["1979851549871354062", "2011793803951137234"],
"platforms": [
// Виберіть лише одну платформу за раз:
// facebook, instagram, youtube, threads, tiktok, або twitter
"twitter"
],
"searchPlatformId": true // Обов'язково
}
Коли кумулятивні метрики (наприклад, лайки, коментарі, перегляди) тимчасово недоступні від соціальної мережі, API автоматично заповнює їх зі збережених даних. Два опціональні поля можуть з’явитися в об’єкті
analytics кожної платформи:backfilledFrom(string, ISO 8601) — Присутнє, коли одна або більше кумулятивних метрик було замінено збереженими даними. Timestamp вказує, коли збережені дані востаннє оновлювалися.recoveredFrom(string, ISO 8601) — Присутнє, коли всю відповідь аналітики було відновлено зі збережених даних через повний збій API. Timestamp вказує, коли збережені дані востаннє оновлювалися.
{
/**
Відповідь така сама, як і для Analytics on a Post.
Будь ласка, див. деталі на тій кінцевій точці.
Примітка: Деякі метрики недоступні для дописів, які не належать авторизованому обліковому запису.
Наприклад: X не повертає non-public metrics або organic metrics для Tweets, не надісланих авторизованим користувачем.
*/
}
{
"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