Перейти до основного вмісту
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 починає відтворюватися або переграється, без мінімальної вимоги до часу перегляду.

Header Parameters

Body Parameters

id
string
обов'язково
Ayrshare Post ID, повернутий з endpoint /post. Це верхньорівневий id Ayrshare, а не соціальні post ID у postIds.
platforms
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.