> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Майбутні зміни API

> Зміни в API, які можуть вплинути на Вашу інтеграцію

Наведені нижче зміни в API набудуть чинності у вказану дату.
Будь ласка, уважно перегляньте потенційно критичні зміни.
Дивіться [What's New](/whatsnew/latest), щоб дізнатися про всі нові функції.

<Update label="June 15, 2026">
  <ul class="custom-bullets">
    <li>
      **Facebook: Meta припинила підтримку метрик Insights unique-impression (reach) та 3-second video-view.** Meta видалила ці метрики у всіх версіях Graph API, тому уражені поля більше не повертаються. Дивіться [Meta Graph API v25 changelog](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/) для деталей.

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post) більше не повертає такі поля Facebook:

          <ul class="custom-bullets">
            <li>impressionsUnique → перейдіть на `mediaView`</li>
            <li>impressionsFanUnique → перейдіть на `mediaView`</li>
            <li>impressionsOrganicUnique → перейдіть на `mediaView`</li>
            <li>impressionsPaidUnique → перейдіть на `mediaViewIsFromAds`</li>
            <li>videoViewsUnique → використовуйте `videoViews` для не-унікальних 3-секундних переглядів</li>
            <li>Сімейства `totalVideoViews*Unique` та `totalVideoImpressions*` (наприклад, `totalVideoViewsOrganicUnique`, `totalVideoViewsPaidUnique`, `totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social) більше не повертає такі поля Facebook:

          <ul class="custom-bullets">
            <li>Сімейство `pagePostsImpressions*` (`pagePostsImpressions`, `pagePostsImpressionsPaid`, `pagePostsImpressionsUnique`, `pagePostsImpressionsOrganicUnique`, `pagePostsImpressionsViral*`, `pagePostsImpressionsNonviral*`) → перейдіть на `pageMediaView`</li>
            <li>pagePostsServedImpressionsOrganicUnique → перейдіть на `pageMediaView`</li>
            <li>pageVideoViewsUnique → використовуйте `pageVideoViews` для не-унікальних 3-секундних переглядів</li>
          </ul>
        </li>

        <li>
          Використовуйте `mediaView` / `pageMediaView` для reach. Планується метрика-наступник Total Unique Media Views. Поля, які досі підтримуються, як-от `reactionsByType`, `videoViews`, `mediaView`, `pagePostEngagements`, `pageVideoViews` та `pageVideoViewsPaid`, не зачеплені.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="May 11, 2026">
  <ul class="custom-bullets">
    <li>
      **Тимчасові збої YouTube тепер повертають HTTP 503/504 замість 500:** Деякі збої завантаження YouTube, що раніше з'являлись як HTTP 500 (`code: 176`), тепер повертають HTTP 503 (`code: 454`) або HTTP 504 (`code: 453`). Обидві відповіді містять `retryAvailable: true`. Клієнтські інтеграції, які фільтрують за HTTP 500 для повторної спроби завантажень YouTube, повинні перейти на фільтрацію за полем `retryAvailable` у тілі відповіді. Дивіться [коди помилок](/errors/errors-ayrshare) для деталей.
    </li>
  </ul>
</Update>

<Update label="April 9, 2026">
  <ul class="custom-bullets">
    <li>
      **Порожня аналітика повертає помилку 187:** Запит [Social Analytics](/apis/analytics/social) або [Post Analytics](/apis/analytics/post), коли жодна платформа не повертає даних, тепер повертає `{ "status": "error", "code": 187 }` замість `{ "status": "success" }`. Оновіть будь-який клієнтський код, який покладається на попередню поведінку порожнього успіху.
    </li>
  </ul>
</Update>

<Update label="March 31, 2026">
  <ul class="custom-bullets">
    <li>
      **Вимога 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](/dashboard/connect-social-accounts/x-twitter-byo-keys) для інструкцій.
    </li>

    <li>
      **RSS-to-X припинено:** Автоматична публікація RSS у X/Twitter більше не підтримуватиметься після 31 березня 2026 року. RSS-стрічки запускаються за розкладом без облікових даних на кожен запит, що несумісно з моделлю BYO key. Автоматична публікація RSS на всі інші платформи не зачіпається.
    </li>

    <li>
      **X Account Activity Webhook припинено:** Дія webhook X Account Activity (`accountActivity`) більше не буде доступна після 31 березня 2026 року. Це включає всі сповіщення про події в реальному часі для прив'язаних облікових записів X (публікації, згадки, DM, лайки, підписки, блокування тощо).
    </li>
  </ul>
</Update>

<Update label="November 14, 2025">
  <ul class="custom-bullets">
    <li>
      Починаючи з 14 листопада 2025 року Facebook припиняє підтримку таких полів для [GET analytics/social](/apis/analytics/social):

      <ul class="custom-bullets">
        <li>pageFans</li>
        <li>pageFansCity</li>
        <li>pageFansLocale</li>
        <li>pageFansCountry</li>
        <li>pageFansAdds</li>
        <li>pageFanAddsUnique</li>
        <li>pageFanRemoves</li>
        <li>pageFanRemovesUnique</li>
        <li>pageImpressions → перейдіть на `pageMediaView`</li>
        <li>pageImpressionsPaidUnique → перейдіть на `pageMediaViewIsFromAds`</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → перейдіть на `pageMediaViewIsFromAds`</li>
      </ul>
    </li>

    <li>
      Починаючи з 14 листопада 2025 року Facebook припиняє підтримку таких полів для [GET analytics/post](/apis/analytics/post):

      <ul class="custom-bullets">
        <li>impressions та impressionsFanPaidUnique → перейдіть на `mediaView`. Деталізовані розбивки доступні через `mediaViewIsFromAds` (перегляди, атрибутовані рекламі) та `mediaViewIsFromFollowers` (перегляди, атрибутовані підписникам).</li>
        <li>postImpressionsUnique (Reels) → використовуйте `blueReelsPlayCount` для кількості відтворень reel або `postVideoViewTime` для загального часу перегляду.</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="September 1, 2025">
  <ul class="custom-bullets">
    <li>
      Починаючи з 1 вересня 2025 року, ендпоінт [get comments](/apis/comments/get-comments) для
      Instagram більше не включатиме поле `text` в об'єктах відповідей. Використовуйте поле `comment`
      для доступу до вмісту відповіді.
    </li>
  </ul>
</Update>

<Update label="June 1, 2025">
  <ul class="custom-bullets">
    <li>
      Ендпоінт [get comments](/apis/comments/get-comments) X (Twitter) перенесе публічні метрики
      користувача до нового об'єкта `publicMetrics`. Такі поля буде перенесено з верхнього
      рівня до об'єкта `publicMetrics`:

      <ul class="custom-bullets">
        <li>followersCount</li>
        <li>followingCount</li>
        <li>tweetCount</li>
        <li>listedCount</li>
        <li>mediaCount</li>
      </ul>
    </li>

    <li>
      Facebook припиняє підтримку таких полів для [GET
      analytics/social](/apis/analytics/social):

      <ul class="custom-bullets">
        <li>pageVideoViews10S</li>
        <li>pageVideoViews10SAutoplayed</li>
        <li>pageVideoViews10SClickToPlay</li>
        <li>pageVideoViews10SOrganic</li>
        <li>pageVideoViews10SPaid</li>
        <li>pageVideoViews10SRepeat</li>
        <li>pageVideoViews10SUnique</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="May 7, 2025">
  <ul class="custom-bullets">
    <li>
      YouTube припинив підтримку налаштування дозволених та заблокованих регіонів. Ви все ще можете
      додавати дозволені та заблоковані регіони до ендпоінту публікації, але вони ігноруватимуться.
    </li>
  </ul>
</Update>

<Update label="April 20, 2025">
  <ul class="custom-bullets">
    <li>
      Наступні метрики для [Instagram post analytics](/apis/analytics/post) будуть припинені:

      REELS:

      <ul class="custom-bullets">
        <li>
          playsCount
        </li>

        <li>
          clipsReplaysCount
        </li>

        <li>
          igReelsAggregatedAllPlaysCount
        </li>
      </ul>

      FEED/STORY:

      <ul class="custom-bullets">
        <li>
          impressionsCount
        </li>
      </ul>
    </li>

    <li>
      [Ендпоінт history](/apis/history/get-history) застосовуватиме кеш на 1 хвилину, якщо `limit` перевищує стандартне значення 25.
    </li>
  </ul>
</Update>

<Update label="March 1, 2025">
  Ендпоінт [get comments](/apis/comments/get-comments) для TikTok стандартизує імена полів,
  щоб узгодити їх з іншими соціальними мережами.

  <ul class="custom-bullets">
    <li>
      Поле `replyList` буде перейменовано на `replies`, а `profileImage` буде перейменовано на
      `profileImageUrl`.
    </li>

    <li>Обидва нові імена полів уже доступні та можуть використовуватись у Вашій інтеграції.</li>

    <li>
      TikTok має такі оновлення:

      <ul class="custom-bullets">
        <li>
          Ендпоінт [social analytics](/apis/analytics/social): відбудуться такі зміни: •
          Поле `durationAverage` буде припинено та видалено. • Через обмеження TikTok API,
          поля `shareCountTotal`, `viewCountTotal` та `commentCountTotal` тепер
          повертатимуть підсумки лише за останні 60 днів замість підсумків за весь час.
          • Щоб почати використовувати підсумки за 60 днів зараз, додайте `period60Days: true` до тіла Вашого API-запиту.
          Примітка: використання цього параметра значно покращить час відповіді.
        </li>

        <li>
          Ендпоінти [history platform](/apis/history/history-platform) та [post
          analytics](/apis/analytics/post): недокументовані поля `caption`, `comments`,
          `shares`, `likes`, `shareUrl` та `itemsId` буде видалено — замість них слід використовувати поля `post`,
          `commentsCount`, `sharesCount`, `likesCount`, `postUrl` та `id`.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="February 1, 2025">
  Ендпоінт [/user](/apis/user/profile-details) змінює спосіб звітування про використання API:

  <ul class="custom-bullets">
    <li>
      Поле `monthlyApiCalls` буде розширено, щоб рахувати всі виклики API (публікації, коментарі,
      аналітику тощо).
    </li>

    <li>Для лічильників, що стосуються лише публікацій, використовуйте нове поле `monthlyPostCount`.</li>

    <li>
      Поле `monthlyApiCallsQuota` буде припинено та замінено новим полем `monthlyPostQuota`.
    </li>
  </ul>
</Update>

<Update label="January 5, 2025">
  <ul class="custom-bullets">
    <li>
      Meta припиняє підтримку поля `videoViews` в Instagram [ендпоінті post analytics](/apis/analytics/post).
    </li>

    <li>
      Крім того, поля `emailContactsCount`, `getDirectionClicks`, `profileViewsCount`,
      `textMessageClicks`, `websiteClicksCount` та `phoneCallClicksCount` буде видалено
      з ендпоінту Instagram [social analytics](/apis/analytics/social).
    </li>

    <li>Ці поля буде видалено 5 січня 2025 року.</li>
  </ul>
</Update>

<Update label="December 15, 2024">
  <ul class="custom-bullets">
    <li>
      Для підвищення безпеки ми заборонимо використання Profile Keys як API Keys. Якщо Ви
      спробуєте використати Profile Key замість API Key, система поверне помилку. [Дивіться
      тут](/apis/overview#authorization), як правильно використовувати Profile Key.
    </li>
  </ul>
</Update>

<Update label="November 15, 2024">
  <ul class="custom-bullets">
    <li>
      Ми оновили спосіб повідомлення про помилки для запланованих webhook TikTok. Ці помилки тепер
      з'являтимуться у масиві errors, узгоджено з нашим обробленням помилок для інших типів запланованих
      webhook. Зверніть увагу, поточні помилки верхнього рівня все ще повертатимуться, але ми заохочуємо використання
      масиву errors.
    </li>

    <li>
      Ендпоінт history тепер за замовчуванням повертатиме відповіді як об'єкти. Параметр objResponse
      буде автоматично встановлено на true.
    </li>

    <li>
      Get All History LinkedIn повертатиме масив для об'єкта mediaUrls. Раніше повертався об'єкт,
      якщо був лише один елемент медіа, і масив, якщо було кілька елементів медіа. Тепер масив
      повертатиметься завжди, навіть якщо є лише один елемент медіа. Якщо Вам потрібна попередня поведінка,
      Ви можете використати параметр запиту `objResponse: false`.
    </li>
  </ul>
</Update>

<Update label="October 7, 2024">
  <ul class="custom-bullets">
    <li>
      Ендпоінт media більше не повертатиме url\_1080. Якщо Вам потрібно змінити розмір зображення,
      дивіться [ендпоінт resize](/apis/media/resize).
    </li>
  </ul>
</Update>

<Update label="September 16, 2024">
  <ul class="custom-bullets">
    <li>
      **Оновлення 25 вересня 2024 року**: Meta (Facebook) випустила припинення підтримки полів, тому
      видалення полів набуло чинності. Будь ласка, дивіться оновлене повернення в [social
      analytics](/apis/analytics/social).
    </li>

    <li>
      Facebook [припиняє підтримку кількох
      полів](https://developers.facebook.com/docs/pages-api/changelog/). [Ендпоінт social analytics
      ](/apis/analytics/social-by-id) більше не повертатиме ці поля після 16 вересня
      2024 року.
    </li>
  </ul>
</Update>

<Update label="June 3, 2024">
  <ul class="custom-bullets">
    <li>
      [Нова система скорочення посилань](/apis/links/overview) замінить ендпоінт shortener,
      підтримку якого припинено Google. Нова система скорочення посилань вимагає додатку [Max
      Pack](/additional/maxpack).
    </li>

    <li>
      Скорочення посилань буде вимкнено (`false`) за замовчуванням. Щоб автоматично скорочувати посилання, використовуйте
      `shortenLinks: true` у виклику ендпоінту публікації, який використовує новий[ ендпоінт
      link](/apis/links/overview).
    </li>
  </ul>
</Update>

<Update label="April 22, 2024">
  <ul class="custom-bullets">
    <li>
      Meta припиняє підтримку свого API Facebook Groups. Будь ласка, дивіться
      [оголошення](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/).
    </li>
  </ul>
</Update>

<Update label="April 16, 2024">
  <ul class="custom-bullets">
    <li>
      Instagram уточнив часовий проміжок набору даних про онлайн-підписників. Дивіться
      [деталі](/apis/analytics/instagram-follower-count).
    </li>
  </ul>
</Update>

<Update label="April 1, 2024">
  <ul class="custom-bullets">
    <li>
      [Reply to comment with comment ID](/apis/comments/reply-to-comment) — стандартна відповідь буде
      об'єктом, як зазначено в документації, замість масиву. Ви можете використовувати параметр objResponse встановлений
      на boolean `false`, якщо хочете зберегти відповідь у вигляді масиву.
    </li>
  </ul>
</Update>

<Update label="January 25, 2024">
  <ul class="custom-bullets">
    <li>
      [Ендпоінт retry post](/apis/post/retry-post) повертатиме статус "pending" замість
      "success", щоб краще відображати статус повторної спроби.
    </li>

    <li>
      [Зміни API для scheduleDate та
      createDate](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022) будуть випущені.
    </li>
  </ul>
</Update>

<Update label="December 8, 2023">
  <ul class="custom-bullets">
    <li>
      Поля `caption`, `message`, `createdTime` та `timestamp` ендпоінту `/history/instagram`
      було припинено 1 квітня 2023 року і буде видалено. Використовуйте поля `post` та
      `created`.
    </li>

    <li>
      Поле `mediaUrls` ендпоінту `/history/linkedin` повертатиметься як масив замість
      об'єкта для підтримки кількох зображень. Ви можете примусово змусити повернення масиву зараз, включивши
      LinkedIn-параметр запиту `?multiMedia=true`. Зверніть увагу, до 1 грудня 2023 року
      параметр запиту `multiMedia` потрібно було використовувати для повернення медіа з кількома зображеннями. Після 1 грудня
      2023 року кілька зображень повертатимуться за замовчуванням.
    </li>

    <li>
      Scheduled Action TikTok webhook матиме припинення підтримки String `platform`. Використовуйте
      поле-масив `platforms`, як це робиться для інших Scheduled Action webhook.
    </li>

    <li>Документацію delete comment було скориговано, щоб узгодити з правильним поверненням.</li>

    <li>
      Поле commentId TikTok буде замінено полем id, щоб узгодити зі стандартним
      форматом видалення коментарів.
    </li>

    <li>
      Повернення видалення коментаря Twitter більше не міститиме масив `posts`, тож повернення узгоджуватиметься
      зі стандартним форматом видалення коментаря. Нове повернення буде таким:
    </li>
  </ul>
</Update>

<Update label="October 18, 2023">
  <ul class="custom-bullets">
    <li>
      Наступні поля YouTube [ендпоінту social analytics](/apis/analytics/social) будуть
      повертатися як числові значення замість String.
    </li>
  </ul>
</Update>

<Update label="May 30, 2023">
  <ul class="custom-bullets">
    <li>
      Ми оновили до нової API-версії Twitter версії 2. Twitter припинив підтримку кількох полів у Version
      2, що впливає на ендпоінти /analytics/social та getAllHistory. Наступні поля
      все ще повертатимуться до 1 вересня 2023 року, але матимуть нульове або порожнє значення рядка.
    </li>
  </ul>
</Update>

<Update label="May 8, 2023">
  <ul class="custom-bullets">
    <li>
      Ми раді запустити [пряму публікацію TikTok](/apis/post/social-networks/tiktok), керування
      коментарями та розширену аналітику. Вашим користувачам більше не потрібно відкривати мобільний застосунок TikTok,
      щоб опублікувати та ввести текст підпису. Тепер після надсилання через Ayrshare відео та підпис TikTok
      публікуються безпосередньо.
    </li>

    <li>
      Ми також представляємо додавання, отримання та видалення коментарів TikTok + дані демографічної
      аналітики.
    </li>

    <li>
      Вашому користувачу потрібно буде відв'язати та повторно прив'язати свій обліковий запис TikTok, щоб увімкнути пряму публікацію.
      Існуючі підключення продовжуватимуть працювати з непрямим методом і вимагатимуть мобільного застосунку TikTok
      для публікації.
    </li>
  </ul>
</Update>

<Update label="February 17, 2023">
  <ul class="custom-bullets">
    <li>
      Google Business Profile змінив доступні дані social analytics. Нові
      доступні поля наступні. Попередні поля все ще будуть присутні, але з нульовим
      значенням, і будуть повністю видалені 17 березня 2023 року.
    </li>
  </ul>
</Update>

<Update label="October 1, 2022">
  <ul class="custom-bullets">
    <li>Поля описів, тексту, повідомлень Get All Posts стандартизовано до поля `post`.</li>
  </ul>
</Update>

<Update label="September 12, 2022">
  <ul class="custom-bullets">
    <li>Поля TikTok припинено: `shareUrl`. Використовуйте `postUrl` замість цього.</li>
  </ul>
</Update>

<Update label="June 17, 2022">
  <ul class="custom-bullets">
    <li>
      Для всіх ендпоінтів history поля `createdAt`, `createdTime` та `timestamp` буде
      замінено полем `created`, яке повертає час створення у форматі UTC.
    </li>

    <li>
      Поле `scheduleDate` більше не повертатиме об'єкт, а рядок, що містить час
      розкладу у форматі UTC.
    </li>

    <li>
      Недокументоване поле `created_date` у /history буде видалено. Використовуйте `created`.
    </li>
  </ul>
</Update>

<Update label="April 22, 2022">
  <ul class="custom-bullets">
    <li>
      Аналітика [публікації Facebook](/apis/analytics/post) повертає `reactions` як об'єкт у
      такому форматі.
    </li>
  </ul>
</Update>

<Update label="April 1, 2022">
  <ul class="custom-bullets">
    <li>
      History за замовчуванням повертатиме останні 20 публікацій. До 500 можна повернути за допомогою
      параметра `lastRecords`.
    </li>
  </ul>
</Update>