Skip to main content
POST
Отримуйте аналітику в реальному часі — лайки, покази, перегляди та реакції — для публікації, надісланої через Ayrshare, за допомогою Ayrshare Post ID. Для аналітики публікацій, створених поза межами Ayrshare, див. Analytics by Social Post ID.
Facebook: деякі метрики охоплення та відео вилучено Meta (15 червня 2026 р.). Meta видалила метрики Insights про унікальні покази та 3-секундні перегляди відео в усіх версіях Graph API, тому об’єкт analytics для Facebook більше не повертає impressionsUnique, impressionsFanUnique, impressionsOrganicUnique, impressionsPaidUnique та videoViewsUnique. Використовуйте mediaView для охоплення (планується наступник Total Unique Media Views). Інші часто вживані поля, як-от reactionsByType та videoViews, не зачіпаються. Посилання: Upcoming API Changes — June 15, 2026.

Додаткова інформація

  • Наразі підтримуються такі платформи: Bluesky, Facebook Pages, Instagram, X/Twitter, LinkedIn, Pinterest, Reddit, Snapchat, Threads, TikTok та YouTube.
  • Кількість коментарів у Facebook та Instagram, повернута в API, може відрізнятися від значень у соціальних застосунках. Це відбувається з двох причин: - Деякі користувачі мають налаштування приватності, які приховують їхні коментарі від не-друзів або користувачів без взаємних зв’язків. Ці приватні коментарі все одно враховуються в загальній кількості коментарів. - Можуть існувати невідповідності в даних, що надаються Meta.
  • Значення Instagram igReelsAggregatedAllPlaysCount та playsCount, повернуті в API, можуть відрізнятися від показників у соціальних застосунках. Це може статися з кількох причин:
    • Публікацію було просунуто. У відповідь API включаються лише органічні перегляди.
    • Можуть існувати невідповідності в даних, що надаються Meta.
  • Треди X/Twitter повертаються як масив об’єктів, де кожен об’єкт відповідає одному твіту в треді.
  • YouTube може обробляти аналітику для відео з невеликою кількістю переглядів або підписників 24-48 годин.
  • Аналітика TikTok:
    • TikTok може оновлювати аналітичні дані (перегляди відео, демографія, лайки, репости та коментарі) 24-48 годин.
    • Для доступу до аналітики TikTok власники облікових записів повинні: 1. Опублікувати щонайменше одне відео. 2. Натиснути кнопку “Turn On” на сторінці Analytics у мобільному застосунку TikTok. 3. Мати 100 підписників, щоб отримувати додаткові інсайти про глядачів та залученість контенту.
    • TikTok не повертає аналітику публікації, якщо медіа містить захищений авторським правом матеріал або було позначено за порушення авторських прав. Приклади захищеного матеріалу можуть включати аудіо у reels (TikTok приглушить такі відео). Ви можете перевірити це у застосунку TikTok у розділі Activity -> System Notifications.
    • Деякі поля аналітики TikTok можуть бути недоступні, якщо відео неактивне понад 7 днів. Щоб отримати ці дані, згенеруйте нову активність на відео (перегляд, лайк, коментар або репост) і повторіть спробу через 24-48 годин. Якщо відео не повертається у відповіді, ймовірна причина — його було відфільтровано через порушення (наприклад, порушення авторських прав на музику). Ці поля включають:
      • reach
      • fullVideoWatchedRate
      • totalTimeWatched
      • averageTimeWatched
      • impressionSources
      • audienceCountries
  • Особисті (member) профілі LinkedIn тепер повертають розширену матрицю аналітики публікацій. Доступні метрики member:
    • impressionCount — покази публікації
    • uniqueImpressionsCount — унікальні охоплені учасники (LinkedIn MEMBERS_REACHED)
    • likeCount — кількість реакцій
    • commentCount — кількість коментарів
    • shareCount — репости публікації
    • engagement — органічні кліки, лайки, коментарі та репости відносно показів
    • reactions — розбивка реакцій за типами (коли реакції присутні)
    • Для відеопублікацій: videoViews, videoViewers та videoWatchTimeMs
    Метрики відео повертаються лише для відеопублікацій і недоступні через понад один рік після створення публікації.
  • Інсайти Instagram Stories доступні лише 24 години, незалежно від того, чи архівовано історії, чи додано до Highlights. Примітка:
    • Медіа-метрики історій зі значеннями меншими за 5 повертаються як 0.
    • Для Stories, створених користувачами в Європі та Японії, метрика replies повертає значення 0.
  • Аналітика Facebook Stories недоступна.
  • Аналітичні дані Pinterest (покази, підписники користувача та кліки) стають доступними через 24-72 години.
  • Для YouTube Shorts перегляди повертають кількість разів, коли Short починає відтворюватися або переграється, без мінімальної вимоги до часу перегляду.

Мультиплатформенні читання та часткова успішність

Один Ayrshare Post ID може охоплювати кілька платформ. Ayrshare розгалужує запит на один leg на платформу і повертає часткову успішність (partial success), коли одні leg-и успішні, а інші зазнають невдачі — аналітика справних платформ завжди повертається, а кожен невдалий leg перелічується у верхньорівневому масиві errors[].
  • Деякі платформи успішні, інші невдалі: відповідь — HTTP 200 з status: “partial”. Справні блоки analytics для кожної платформи повертаються як зазвичай, а верхньорівневий масив errors[] перелічує кожен невдалий leg із його platform, status, code, message та id.
  • Кожна платформа зазнає невдачі: відповідь має status: “error” і повний масив errors[]. HTTP-статус зіставляється з репрезентативного верхньорівневого коду помилки. Код 485 зіставляється з HTTP 404; інші репрезентативні коди використовують власні зіставлення.
  • Усі платформи успішні: відповідь не змінюється — HTTP 200, status: “success” та без ключа errors[].
Зміна поведінки — перевіряйте errors[], не розгалужуйтесь за HTTP-статусом. Оскільки мультиплатформенне читання з невдалим leg тепер повертає HTTP 200 замість згортання всієї відповіді в помилку, інтегратори повинні завжди перевіряти наявність верхньорівневого масиву errors[], щоб виявити збої окремих платформ, замість того щоб покладатися лише на HTTP-статус.

Застарілі або недоступні аналітики Instagram Story

Leg аналітики Instagram Story, що застарів або недоступний — так що його insights не можна отримати — з’являється в errors[] з кодом 485. Репрезентативне повідомлення — “Instagram Story expired or unavailable — comments/insights cannot be retrieved.” Аналітика Facebook Story залишається недоступною і не охоплюється цією поведінкою. Якщо інша платформа успішна, її аналітика все одно повертається, а загальна відповідь — HTTP 200. Для відповіді з повним провалом репрезентативний код 485 зіставляється з HTTP 404; інші репрезентативні коди використовують власні зіставлення. Зіставляйте за code (485), а не за точним текстом повідомлення. (Див. також примітку вище: insights Instagram Story доступні лише протягом 24 годин.)

Приклад: Відповідь із частковою успішністю

200: Часткова успішність

Header Parameters

Body Parameters

string
обов'язково
Ayrshare Post ID, повернутий з endpoint /post. Це верхньорівневий id Ayrshare, а не соціальні post ID у postIds.
array
Масив рядків платформ для отримання аналітики. Приймає масив рядків зі значеннями:
Якщо platforms не вказано, аналітика буде повернута для всіх соціальних мереж, до яких було надіслано публікацію.
Коли кумулятивні метрики (наприклад, лайки, коментарі, перегляди) тимчасово недоступні від соціальної мережі, API автоматично заповнює їх зі збережених даних. Два необов’язкові поля можуть з’явитися в об’єкті analytics для конкретної платформи:
  • backfilledFrom (string, ISO 8601) — присутнє, коли одну або кілька кумулятивних метрик було замінено значеннями зі збережених даних. Часова мітка вказує, коли збережені дані востаннє оновлювалися.
  • recoveredFrom (string, ISO 8601) — присутнє, коли повну відповідь аналітики було відновлено зі збережених даних через повний збій API. Часова мітка вказує, коли збережені дані востаннє оновлювалися.
Збережені дані, старші за 4 дні, вважаються застарілими та не використовуються для backfill або відновлення.
Аналітика особистих (member) профілів LinkedIn — потрібне повторне підключення. Особисті профілі LinkedIn, підключені до випуску member post analytics, не мають потрібних scope для аналітики. Запити аналітики для таких профілів повертають код помилки 475 (“re-link your LinkedIn profile to enable analytics”). Власник облікового запису має повторно підключити свій профіль LinkedIn на сторінці Social Accounts, щоб надати нові scope. Зачекайте кілька хвилин після повторного підключення, щоб код 475 очистився (Ayrshare і LinkedIn обидва короткочасно кешують стан дозволів, зазвичай ~5-10 хвилин). На публікацію це не впливає.Кількості публікацій member для LinkedIn є best-effort: агреговані підсумки shareCount (RESHARE), likeCount (REACTION) та commentCount (COMMENT) можуть незначно відрізнятися від чисел, показаних в інтерфейсі LinkedIn.