Skip to main content
POST
/apis/analytics/social-by-id — це сторінка документації, а не маршрут API. Надсилайте запити для одного допису й пакетні запити до POST /analytics/post, указавши рівно одне значення в platforms і searchPlatformId: true: {"id":"SOCIAL_POST_ID","platforms":["twitter"],"searchPlatformId":true} для одного допису або {"postIds":["ID_1","ID_2"],"platforms":["twitter"],"searchPlatformId":true} для максимум 100 дописів.
Отримайте аналітику для дописів, які не походять через 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 для отримання аналітики кількох дописів в одному запиті.
​
string
Social Post ID, повернений з кінцевої точки /post. Це поле id для окремої соціальної мережі, знайдене в масиві postIds. Потрібен або id, або postIds.
​
array
Масив Social Post IDs для отримання аналітики кількох дописів в одному запиті. Максимум 100 ID. Потрібен або id, або postIds.
​
array
обов'язково
Рядковий масив платформ для отримання аналітики. Дозволено лише одне значення.Доступні значення:
​
boolean
за замовчуванням:false
обов'язково
Встановіть у true, щоб шукати за Social Post ID.
Коли кумулятивні метрики (наприклад, лайки, коментарі, перегляди) тимчасово недоступні від соціальної мережі, API автоматично заповнює їх зі збережених даних. Два опціональні поля можуть з’явитися в об’єкті analytics кожної платформи:
  • backfilledFrom (string, ISO 8601) — Присутнє, коли одна або більше кумулятивних метрик було замінено збереженими даними. Timestamp вказує, коли збережені дані востаннє оновлювалися.
  • recoveredFrom (string, ISO 8601) — Присутнє, коли всю відповідь аналітики було відновлено зі збережених даних через повний збій API. Timestamp вказує, коли збережені дані востаннє оновлювалися.
Збережені дані старші 4 днів вважаються застарілими і не використовуються для заповнення або відновлення.
Відповідь із code: 186 означає, що Social Post ID не знайдено для вибраного облікового запису та платформи. URL у повідомленні повертає на цю сторінку документації, а не вказує на інший endpoint API. Виправте запит і повторіть POST /analytics/post, використовуючи один із форматів вище.