Skip to main content
Наведені нижче зміни в API набудуть чинності у вказану дату. Будь ласка, уважно перегляньте потенційно критичні зміни. Дивіться What’s New, щоб дізнатися про всі нові функції.
​
  • Facebook: Meta припинила підтримку метрик Insights unique-impression (reach) та 3-second video-view. Meta видалила ці метрики у всіх версіях Graph API, тому уражені поля більше не повертаються. Дивіться Meta Graph API v25 changelog для деталей.
    • GET analytics/post більше не повертає такі поля Facebook:
      • impressionsUnique → перейдіть на mediaView
      • impressionsFanUnique → перейдіть на mediaView
      • impressionsOrganicUnique → перейдіть на mediaView
      • impressionsPaidUnique → перейдіть на mediaViewIsFromAds
      • videoViewsUnique → використовуйте videoViews для не-унікальних 3-секундних переглядів
      • Сімейства totalVideoViews*Unique та totalVideoImpressions* (наприклад, totalVideoViewsOrganicUnique, totalVideoViewsPaidUnique, totalVideoViewsUnique)
    • GET analytics/social більше не повертає такі поля Facebook:
      • Сімейство pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*) → перейдіть на pageMediaView
      • pagePostsServedImpressionsOrganicUnique → перейдіть на pageMediaView
      • pageVideoViewsUnique → використовуйте pageVideoViews для не-унікальних 3-секундних переглядів
    • Використовуйте mediaView / pageMediaView для reach. Планується метрика-наступник Total Unique Media Views. Поля, які досі підтримуються, як-от reactionsByType, videoViews, mediaView, pagePostEngagements, pageVideoViews та pageVideoViewsPaid, не зачеплені.
​
  • Тимчасові збої YouTube тепер повертають HTTP 503/504 замість 500: Деякі збої завантаження YouTube, що раніше з’являлись як HTTP 500 (code: 176), тепер повертають HTTP 503 (code: 454) або HTTP 504 (code: 453). Обидві відповіді містять retryAvailable: true. Клієнтські інтеграції, які фільтрують за HTTP 500 для повторної спроби завантажень YouTube, повинні перейти на фільтрацію за полем retryAvailable у тілі відповіді. Дивіться коди помилок для деталей.
​
  • Порожня аналітика повертає помилку 187: Запит Social Analytics або Post Analytics, коли жодна платформа не повертає даних, тепер повертає { "status": "error", "code": 187 } замість { "status": "success" }. Оновіть будь-який клієнтський код, який покладається на попередню поведінку порожнього успіху.
​
  • Вимога BYO Key для X/Twitter: Усі операції X/Twitter через Ayrshare вимагатимуть Ваших власних API-облікових даних. Після прив’язки Вашого X-облікового запису через OAuth включіть 2 заголовки в кожен запит X/Twitter: X-Twitter-OAuth1-Api-Key та X-Twitter-OAuth1-Api-Secret. Запити без валідних облікових даних будуть відхилені. Дивіться X BYO Key Setup Guide для інструкцій.
  • RSS-to-X припинено: Автоматична публікація RSS у X/Twitter більше не підтримуватиметься після 31 березня 2026 року. RSS-стрічки запускаються за розкладом без облікових даних на кожен запит, що несумісно з моделлю BYO key. Автоматична публікація RSS на всі інші платформи не зачіпається.
  • X Account Activity Webhook припинено: Дія webhook X Account Activity (accountActivity) більше не буде доступна після 31 березня 2026 року. Це включає всі сповіщення про події в реальному часі для прив’язаних облікових записів X (публікації, згадки, DM, лайки, підписки, блокування тощо).
​
  • Починаючи з 14 листопада 2025 року Facebook припиняє підтримку таких полів для GET analytics/social:
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → перейдіть на pageMediaView
    • pageImpressionsPaidUnique → перейдіть на pageMediaViewIsFromAds
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → перейдіть на pageMediaViewIsFromAds
  • Починаючи з 14 листопада 2025 року Facebook припиняє підтримку таких полів для GET analytics/post:
    • impressions та impressionsFanPaidUnique → перейдіть на mediaView. Деталізовані розбивки доступні через mediaViewIsFromAds (перегляди, атрибутовані рекламі) та mediaViewIsFromFollowers (перегляди, атрибутовані підписникам).
    • postImpressionsUnique (Reels) → використовуйте blueReelsPlayCount для кількості відтворень reel або postVideoViewTime для загального часу перегляду.
​
  • Починаючи з 1 вересня 2025 року, ендпоінт get comments для Instagram більше не включатиме поле text в об’єктах відповідей. Використовуйте поле comment для доступу до вмісту відповіді.
​
  • Ендпоінт get comments X (Twitter) перенесе публічні метрики користувача до нового об’єкта publicMetrics. Такі поля буде перенесено з верхнього рівня до об’єкта publicMetrics:
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • Facebook припиняє підтримку таких полів для GET analytics/social:
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
  • YouTube припинив підтримку налаштування дозволених та заблокованих регіонів. Ви все ще можете додавати дозволені та заблоковані регіони до ендпоінту публікації, але вони ігноруватимуться.
​
  • Наступні метрики для Instagram post analytics будуть припинені:REELS:
    • playsCount
    • clipsReplaysCount
    • igReelsAggregatedAllPlaysCount
    FEED/STORY:
    • impressionsCount
  • Ендпоінт history застосовуватиме кеш на 1 хвилину, якщо limit перевищує стандартне значення 25.
​
Ендпоінт get comments для TikTok стандартизує імена полів, щоб узгодити їх з іншими соціальними мережами.
  • Поле replyList буде перейменовано на replies, а profileImage буде перейменовано на profileImageUrl.
  • Обидва нові імена полів уже доступні та можуть використовуватись у Вашій інтеграції.
  • TikTok має такі оновлення:
    • Ендпоінт social analytics: відбудуться такі зміни: • Поле durationAverage буде припинено та видалено. • Через обмеження TikTok API, поля shareCountTotal, viewCountTotal та commentCountTotal тепер повертатимуть підсумки лише за останні 60 днів замість підсумків за весь час. • Щоб почати використовувати підсумки за 60 днів зараз, додайте period60Days: true до тіла Вашого API-запиту. Примітка: використання цього параметра значно покращить час відповіді.
    • Ендпоінти history platform та post analytics: недокументовані поля caption, comments, shares, likes, shareUrl та itemsId буде видалено — замість них слід використовувати поля post, commentsCount, sharesCount, likesCount, postUrl та id.
​
Ендпоінт /user змінює спосіб звітування про використання API:
  • Поле monthlyApiCalls буде розширено, щоб рахувати всі виклики API (публікації, коментарі, аналітику тощо).
  • Для лічильників, що стосуються лише публікацій, використовуйте нове поле monthlyPostCount.
  • Поле monthlyApiCallsQuota буде припинено та замінено новим полем monthlyPostQuota.
​
  • Meta припиняє підтримку поля videoViews в Instagram ендпоінті post analytics.
  • Крім того, поля emailContactsCount, getDirectionClicks, profileViewsCount, textMessageClicks, websiteClicksCount та phoneCallClicksCount буде видалено з ендпоінту Instagram social analytics.
  • Ці поля буде видалено 5 січня 2025 року.
​
  • Для підвищення безпеки ми заборонимо використання Profile Keys як API Keys. Якщо Ви спробуєте використати Profile Key замість API Key, система поверне помилку. Дивіться тут, як правильно використовувати Profile Key.
​
  • Ми оновили спосіб повідомлення про помилки для запланованих webhook TikTok. Ці помилки тепер з’являтимуться у масиві errors, узгоджено з нашим обробленням помилок для інших типів запланованих webhook. Зверніть увагу, поточні помилки верхнього рівня все ще повертатимуться, але ми заохочуємо використання масиву errors.
  • Ендпоінт history тепер за замовчуванням повертатиме відповіді як об’єкти. Параметр objResponse буде автоматично встановлено на true.
  • Get All History LinkedIn повертатиме масив для об’єкта mediaUrls. Раніше повертався об’єкт, якщо був лише один елемент медіа, і масив, якщо було кілька елементів медіа. Тепер масив повертатиметься завжди, навіть якщо є лише один елемент медіа. Якщо Вам потрібна попередня поведінка, Ви можете використати параметр запиту objResponse: false.
​
  • Ендпоінт media більше не повертатиме url_1080. Якщо Вам потрібно змінити розмір зображення, дивіться ендпоінт resize.
​
​
  • Нова система скорочення посилань замінить ендпоінт shortener, підтримку якого припинено Google. Нова система скорочення посилань вимагає додатку Max Pack.
  • Скорочення посилань буде вимкнено (false) за замовчуванням. Щоб автоматично скорочувати посилання, використовуйте shortenLinks: true у виклику ендпоінту публікації, який використовує новий ендпоінт link.
​
  • Meta припиняє підтримку свого API Facebook Groups. Будь ласка, дивіться оголошення.
​
  • Instagram уточнив часовий проміжок набору даних про онлайн-підписників. Дивіться деталі.
​
  • Reply to comment with comment ID — стандартна відповідь буде об’єктом, як зазначено в документації, замість масиву. Ви можете використовувати параметр objResponse встановлений на boolean false, якщо хочете зберегти відповідь у вигляді масиву.
​
​
  • Поля caption, message, createdTime та timestamp ендпоінту /history/instagram було припинено 1 квітня 2023 року і буде видалено. Використовуйте поля post та created.
  • Поле mediaUrls ендпоінту /history/linkedin повертатиметься як масив замість об’єкта для підтримки кількох зображень. Ви можете примусово змусити повернення масиву зараз, включивши LinkedIn-параметр запиту ?multiMedia=true. Зверніть увагу, до 1 грудня 2023 року параметр запиту multiMedia потрібно було використовувати для повернення медіа з кількома зображеннями. Після 1 грудня 2023 року кілька зображень повертатимуться за замовчуванням.
  • Scheduled Action TikTok webhook матиме припинення підтримки String platform. Використовуйте поле-масив platforms, як це робиться для інших Scheduled Action webhook.
  • Документацію delete comment було скориговано, щоб узгодити з правильним поверненням.
  • Поле commentId TikTok буде замінено полем id, щоб узгодити зі стандартним форматом видалення коментарів.
  • Повернення видалення коментаря Twitter більше не міститиме масив posts, тож повернення узгоджуватиметься зі стандартним форматом видалення коментаря. Нове повернення буде таким:
​
​
  • Ми оновили до нової API-версії Twitter версії 2. Twitter припинив підтримку кількох полів у Version 2, що впливає на ендпоінти /analytics/social та getAllHistory. Наступні поля все ще повертатимуться до 1 вересня 2023 року, але матимуть нульове або порожнє значення рядка.
​
  • Ми раді запустити пряму публікацію TikTok, керування коментарями та розширену аналітику. Вашим користувачам більше не потрібно відкривати мобільний застосунок TikTok, щоб опублікувати та ввести текст підпису. Тепер після надсилання через Ayrshare відео та підпис TikTok публікуються безпосередньо.
  • Ми також представляємо додавання, отримання та видалення коментарів TikTok + дані демографічної аналітики.
  • Вашому користувачу потрібно буде відв’язати та повторно прив’язати свій обліковий запис TikTok, щоб увімкнути пряму публікацію. Існуючі підключення продовжуватимуть працювати з непрямим методом і вимагатимуть мобільного застосунку TikTok для публікації.
​
  • Google Business Profile змінив доступні дані social analytics. Нові доступні поля наступні. Попередні поля все ще будуть присутні, але з нульовим значенням, і будуть повністю видалені 17 березня 2023 року.
​
  • Поля описів, тексту, повідомлень Get All Posts стандартизовано до поля post.
​
  • Поля TikTok припинено: shareUrl. Використовуйте postUrl замість цього.
​
  • Для всіх ендпоінтів history поля createdAt, createdTime та timestamp буде замінено полем created, яке повертає час створення у форматі UTC.
  • Поле scheduleDate більше не повертатиме об’єкт, а рядок, що містить час розкладу у форматі UTC.
  • Недокументоване поле created_date у /history буде видалено. Використовуйте created.
​
​
  • History за замовчуванням повертатиме останні 20 публікацій. До 500 можна повернути за допомогою параметра lastRecords.