> ## 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.

# Próximas Mudanças na API

> Mudanças na API que podem impactar sua integração

As seguintes mudanças na API entrarão em vigor na data especificada.
Revise cuidadosamente para verificar quaisquer mudanças potencialmente disruptivas.
Consulte [Novidades](/whatsnew/latest) para todos os novos recursos.

<Update label="15 de Junho, 2026">
  <ul class="custom-bullets">
    <li>
      **Facebook: A Meta descontinuou as métricas Insights de impressões únicas (reach) e visualização de vídeo de 3 segundos.** A Meta removeu essas métricas em todas as versões da Graph API, então os campos afetados não são mais retornados. Consulte o [changelog da Meta Graph API v25](https://developers.facebook.com/blog/post/2026/02/18/introducing-graph-api-v25-and-marketing-api-v25/) para detalhes.

      <ul class="custom-bullets">
        <li>
          [GET analytics/post](/apis/analytics/post) não retorna mais os seguintes campos do Facebook:

          <ul class="custom-bullets">
            <li>impressionsUnique → migre para `mediaView`</li>
            <li>impressionsFanUnique → migre para `mediaView`</li>
            <li>impressionsOrganicUnique → migre para `mediaView`</li>
            <li>impressionsPaidUnique → migre para `mediaViewIsFromAds`</li>
            <li>videoViewsUnique → use `videoViews` para visualizações de 3 segundos não únicas</li>
            <li>As famílias `totalVideoViews*Unique` e `totalVideoImpressions*` (por exemplo, `totalVideoViewsOrganicUnique`, `totalVideoViewsPaidUnique`, `totalVideoViewsUnique`)</li>
          </ul>
        </li>

        <li>
          [GET analytics/social](/apis/analytics/social) não retorna mais os seguintes campos do Facebook:

          <ul class="custom-bullets">
            <li>A família `pagePostsImpressions*` (`pagePostsImpressions`, `pagePostsImpressionsPaid`, `pagePostsImpressionsUnique`, `pagePostsImpressionsOrganicUnique`, `pagePostsImpressionsViral*`, `pagePostsImpressionsNonviral*`) → migre para `pageMediaView`</li>
            <li>pagePostsServedImpressionsOrganicUnique → migre para `pageMediaView`</li>
            <li>pageVideoViewsUnique → use `pageVideoViews` para visualizações de 3 segundos não únicas</li>
          </ul>
        </li>

        <li>
          Use `mediaView` / `pageMediaView` para alcance. Uma métrica sucessora Total Unique Media Views está planejada. Campos ainda suportados como `reactionsByType`, `videoViews`, `mediaView`, `pagePostEngagements`, `pageVideoViews` e `pageVideoViewsPaid` não são afetados.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="11 de Maio, 2026">
  <ul class="custom-bullets">
    <li>
      **Falhas transientes do YouTube agora retornam HTTP 503/504 em vez de 500:** Algumas falhas de upload no YouTube que anteriormente eram expostas como HTTP 500 (`code: 176`) agora retornam HTTP 503 (`code: 454`) ou HTTP 504 (`code: 453`). Ambas as respostas incluem `retryAvailable: true`. Integrações de clientes que filtram por HTTP 500 para tentar novamente uploads no YouTube devem passar a filtrar pelo campo `retryAvailable` no corpo da resposta. Consulte [códigos de erro](/errors/errors-ayrshare) para detalhes.
    </li>
  </ul>
</Update>

<Update label="9 de Abril, 2026">
  <ul class="custom-bullets">
    <li>
      **Análises Vazias Retornam Erro 187:** Solicitar [Social Analytics](/apis/analytics/social) ou [Post Analytics](/apis/analytics/post) quando nenhuma plataforma retorna dados agora retorna `{ "status": "error", "code": 187 }` em vez de `{ "status": "success" }`. Atualize qualquer código do cliente que dependa do comportamento anterior de sucesso vazio.
    </li>
  </ul>
</Update>

<Update label="31 de Março, 2026">
  <ul class="custom-bullets">
    <li>
      **Requisito de Chave BYO do X/Twitter:** Todas as operações do X/Twitter pela Ayrshare exigirão suas próprias credenciais de API. Após vincular sua conta X via OAuth, inclua 2 cabeçalhos em cada requisição do X/Twitter: `X-Twitter-OAuth1-Api-Key` e `X-Twitter-OAuth1-Api-Secret`. Requisições sem credenciais válidas serão rejeitadas. Consulte o [Guia de Configuração de Chave X BYO](/dashboard/connect-social-accounts/x-twitter-byo-keys) para instruções.
    </li>

    <li>
      **RSS-para-X Descontinuado:** A auto-publicação RSS para X/Twitter não será mais suportada após 31 de março de 2026. Feeds RSS rodam em um cronograma sem credenciais por requisição, o que é incompatível com o modelo de chave BYO. A auto-publicação RSS para todas as outras plataformas não é afetada.
    </li>

    <li>
      **Webhook X Account Activity Descontinuado:** A ação de webhook X Account Activity (`accountActivity`) não estará mais disponível após 31 de março de 2026. Isso inclui todas as notificações de eventos em tempo real para contas X vinculadas (posts, menções, DMs, curtidas, follows, blocks, etc.).
    </li>
  </ul>
</Update>

<Update label="14 de Novembro, 2025">
  <ul class="custom-bullets">
    <li>
      A partir de 14 de novembro de 2025, o Facebook descontinuará os seguintes campos para [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 → migre para `pageMediaView`</li>
        <li>pageImpressionsPaidUnique → migre para `pageMediaViewIsFromAds`</li>
        <li>pageImpressionsUnique</li>
        <li>pageImpressionsViral</li>
        <li>pageImpressionsViralUnique</li>
        <li>pageImpressionsPaid → migre para `pageMediaViewIsFromAds`</li>
      </ul>
    </li>

    <li>
      A partir de 14 de novembro de 2025, o Facebook descontinuará os seguintes campos para [GET analytics/post](/apis/analytics/post):

      <ul class="custom-bullets">
        <li>impressions e impressionsFanPaidUnique → migre para `mediaView`. Desagregações granulares disponíveis via `mediaViewIsFromAds` (visualizações atribuídas a anúncios) e `mediaViewIsFromFollowers` (visualizações atribuídas a seguidores).</li>
        <li>postImpressionsUnique (Reels) → use `blueReelsPlayCount` para contagem de reproduções de reel ou `postVideoViewTime` para tempo total de visualização.</li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 de Setembro, 2025">
  <ul class="custom-bullets">
    <li>
      A partir de 1 de setembro de 2025, o endpoint [get comments](/apis/comments/get-comments) para
      Instagram não incluirá mais o campo `text` em objetos de resposta. Use o campo `comment`
      em vez disso para acessar o conteúdo da resposta.
    </li>
  </ul>
</Update>

<Update label="1 de Junho, 2025">
  <ul class="custom-bullets">
    <li>
      O endpoint [get comments](/apis/comments/get-comments) do X (Twitter) moverá as métricas
      públicas do usuário para o novo objeto `publicMetrics`. Os seguintes campos serão movidos do
      nível superior para o objeto `publicMetrics`:

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

    <li>
      O Facebook descontinuará os seguintes campos para [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="7 de Maio, 2025">
  <ul class="custom-bullets">
    <li>
      O YouTube descontinuou a configuração de regiões permitidas e bloqueadas. Você ainda pode adicionar
      as regiões permitidas e bloqueadas no endpoint post, mas elas serão ignoradas.
    </li>
  </ul>
</Update>

<Update label="20 de Abril, 2025">
  <ul class="custom-bullets">
    <li>
      As seguintes métricas para [análises de posts do Instagram](/apis/analytics/post) serão descontinuadas:

      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>
      O [endpoint history](/apis/history/get-history) aplicará cache de 1 minuto se o `limit` for maior que o valor padrão de 25.
    </li>
  </ul>
</Update>

<Update label="1 de Março, 2025">
  O endpoint [get comments](/apis/comments/get-comments) para TikTok padronizará os nomes de campos
  para corresponder a outras redes sociais.

  <ul class="custom-bullets">
    <li>
      O campo `replyList` será renomeado para `replies` e `profileImage` será renomeado para
      `profileImageUrl`.
    </li>

    <li>Ambos os novos nomes de campo já estão disponíveis e podem ser usados na sua integração.</li>

    <li>
      TikTok tem as seguintes atualizações:

      <ul class="custom-bullets">
        <li>
          Endpoint [social analytics](/apis/analytics/social): As seguintes mudanças estão chegando: •
          O campo `durationAverage` será descontinuado e removido. • Devido a limitações da API do TikTok, os campos `shareCountTotal`, `viewCountTotal` e `commentCountTotal` agora
          retornarão apenas totais dos últimos 60 dias em vez de totais vitalícios. • Para começar a usar
          os totais de 60 dias agora, adicione `period60Days: true` ao corpo da sua requisição de API. Observação: Usar esse parâmetro melhorará significativamente os tempos de resposta.
        </li>

        <li>
          Endpoints [history platform](/apis/history/history-platform) e [post
          analytics](/apis/analytics/post): Os campos não documentados `caption`, `comments`,
          `shares`, `likes`, `shareUrl` e `itemsId` serão removidos - os campos `post`,
          `commentsCount`, `sharesCount`, `likesCount`, `postUrl` e `id` devem ser usados em vez disso.
        </li>
      </ul>
    </li>
  </ul>
</Update>

<Update label="1 de Fevereiro, 2025">
  O endpoint [/user](/apis/user/profile-details) está mudando como reporta o uso de API:

  <ul class="custom-bullets">
    <li>
      O campo `monthlyApiCalls` será expandido para contar todas as chamadas de API (posts, comentários,
      análises, etc.).
    </li>

    <li>Para contagens específicas de posts, use o novo campo `monthlyPostCount`.</li>

    <li>
      O campo `monthlyApiCallsQuota` será descontinuado e substituído pelo novo campo `monthlyPostQuota`.
    </li>
  </ul>
</Update>

<Update label="5 de Janeiro, 2025">
  <ul class="custom-bullets">
    <li>
      A Meta está descontinuando o campo `videoViews` no [endpoint de análises de posts](/apis/analytics/post)
      do Instagram.
    </li>

    <li>
      Além disso, os campos `emailContactsCount`, `getDirectionClicks`, `profileViewsCount`,
      `textMessageClicks`, `websiteClicksCount` e `phoneCallClicksCount` serão removidos
      do endpoint [social analytics](/apis/analytics/social) do Instagram.
    </li>

    <li>Esses campos serão removidos em 5 de janeiro de 2025.</li>
  </ul>
</Update>

<Update label="15 de Dezembro, 2024">
  <ul class="custom-bullets">
    <li>
      Para segurança aprimorada, impediremos que Profile Keys sejam usadas como API Keys. Se você
      tentar usar uma Profile Key no lugar da API Key, o sistema retornará um erro. [Veja
      aqui](/apis/overview#authorization) sobre como usar corretamente uma Profile Key.
    </li>
  </ul>
</Update>

<Update label="15 de Novembro, 2024">
  <ul class="custom-bullets">
    <li>
      Atualizamos como os erros para webhooks agendados do TikTok são reportados. Esses erros agora
      aparecerão no array de erros, consistente com nosso tratamento de erros para outros tipos de
      webhook agendado. Observe que os atuais erros de nível superior ainda serão retornados, mas incentivamos o uso do
      array de erros.
    </li>

    <li>
      O endpoint history agora retornará respostas como objetos por padrão. O parâmetro objResponse
      será definido como true automaticamente.
    </li>

    <li>
      Get All History LinkedIn retornará um array para o objeto mediaUrls. Anteriormente, um objeto
      era retornado se apenas um item de mídia e um array se múltiplos itens de mídia. Agora um array será
      sempre retornado, mesmo se apenas um item de mídia. Se precisar do comportamento anterior, você
      pode usar o parâmetro de query `objResponse: false`.
    </li>
  </ul>
</Update>

<Update label="7 de Outubro, 2024">
  <ul class="custom-bullets">
    <li>
      O endpoint media não retornará mais url\_1080. Se você precisar redimensionar uma imagem,
      consulte o [endpoint resize](/apis/media/resize).
    </li>
  </ul>
</Update>

<Update label="16 de Setembro, 2024">
  <ul class="custom-bullets">
    <li>
      **Atualização 25 de setembro de 2024**: A Meta (Facebook) lançou a descontinuação dos campos, então a
      remoção dos campos está em vigor. Veja a resposta atualizada em [social
      analytics](/apis/analytics/social).
    </li>

    <li>
      O Facebook [descontinuará vários
      campos](https://developers.facebook.com/docs/pages-api/changelog/). O [endpoint social analytics](/apis/analytics/social-by-id) não retornará mais esses campos após 16 de setembro de 2024.
    </li>
  </ul>
</Update>

<Update label="3 de Junho, 2024">
  <ul class="custom-bullets">
    <li>
      O [novo sistema de encurtador de links](/apis/links/overview) substituirá o endpoint shortener,
      que foi descontinuado pelo Google. O novo encurtador de link requer o add-on [Max
      Pack](/additional/maxpack).
    </li>

    <li>
      O encurtamento de link estará desligado (`false`) por padrão. Para encurtar links automaticamente use
      `shortenLinks: true` na chamada do endpoint post, que usa o novo [endpoint
      link](/apis/links/overview).
    </li>
  </ul>
</Update>

<Update label="22 de Abril, 2024">
  <ul class="custom-bullets">
    <li>
      A Meta descontinuará sua API de Grupos do Facebook. Consulte o
      [anúncio](https://www.ayrshare.com/blog/facebook-removes-groups-api-access-impact-and-implications/).
    </li>
  </ul>
</Update>

<Update label="16 de Abril, 2024">
  <ul class="custom-bullets">
    <li>
      O Instagram esclareceu o período de tempo do conjunto de dados de seguidores online. Consulte aqui para
      [detalhes](/apis/analytics/instagram-follower-count).
    </li>
  </ul>
</Update>

<Update label="1 de Abril, 2024">
  <ul class="custom-bullets">
    <li>
      A resposta padrão de [Reply to comment with comment ID](/apis/comments/reply-to-comment) será
      um objeto conforme listado nos docs em vez de um Array. Você pode usar o parâmetro objResponse definido
      como boolean `false` se desejar manter uma resposta Array.
    </li>
  </ul>
</Update>

<Update label="25 de Janeiro, 2024">
  <ul class="custom-bullets">
    <li>
      O [endpoint retry post](/apis/post/retry-post) retornará um status de "pending" em vez de
      "success" para refletir melhor o status do retry.
    </li>

    <li>
      As [mudanças na API em scheduleDate e
      createDate](/whatsnew/upcoming-api-changes#changes-in-effect-june-17-2022) serão lançadas.
    </li>
  </ul>
</Update>

<Update label="8 de Dezembro, 2023">
  <ul class="custom-bullets">
    <li>
      Os campos `caption`, `message`, `createdTime` e `timestamp` do endpoint `/history/instagram`
      foram descontinuados em 1 de abril de 2023 e serão removidos. Use os campos `post` e
      `created`.
    </li>

    <li>
      O campo `mediaUrls` do endpoint `/history/linkedin` será retornado como array em vez de
      objeto para suportar múltiplas imagens. Você pode forçar o retorno do array agora incluindo o
      parâmetro de query do LinkedIn `?multiMedia=true`. Observe que antes de 1 de dezembro de 2023 o
      parâmetro de query `multiMedia` deve ser usado para retornar mídia com múltiplas imagens. Após 1 de dezembro
      de 2023, múltiplas imagens serão retornadas por padrão.
    </li>

    <li>
      No webhook Scheduled Action do TikTok, a String `platform` será descontinuada. Use o
      campo array `platforms` como é feito para outros webhooks Scheduled Action.
    </li>

    <li>Os docs de delete comment foram corrigidos para se alinhar com o retorno correto.</li>

    <li>
      O campo commentId do TikTok será substituído pelo campo id para se alinhar com o formato
      padrão de exclusão de comentário.
    </li>

    <li>
      O retorno de delete comment do Twitter não conterá mais um array `posts` para que o retorno se alinhe
      com o formato padrão de exclusão de comentário. O novo retorno será o seguinte:
    </li>
  </ul>
</Update>

<Update label="18 de Outubro, 2023">
  <ul class="custom-bullets">
    <li>
      Os seguintes campos do YouTube no [endpoint social analytics](/apis/analytics/social) serão
      retornados como valores numéricos em vez de String.
    </li>
  </ul>
</Update>

<Update label="30 de Maio, 2023">
  <ul class="custom-bullets">
    <li>
      Fizemos upgrade para a nova versão 2 da API do Twitter. O Twitter descontinuou alguns campos na Versão
      2, o que afeta os endpoints /analytics/social e getAllHistory. Esses seguintes campos
      ainda serão retornados até 1 de setembro de 2023, mas terão um valor zero ou string vazia.
    </li>
  </ul>
</Update>

<Update label="8 de Maio, 2023">
  <ul class="custom-bullets">
    <li>
      Estamos animados em lançar [publicação direta no TikTok](/apis/post/social-networks/tiktok), gerenciamento
      de comentários e análises avançadas. Seus usuários não precisarão mais abrir o app mobile do TikTok
      para publicar e inserir o texto da legenda. Agora, após enviar via Ayrshare, o vídeo e a legenda
      do TikTok são publicados diretamente.
    </li>

    <li>
      Também estamos introduzindo adicionar, obter e excluir comentários do TikTok + dados analíticos
      demográficos.
    </li>

    <li>
      Seu usuário precisará desvincular e re-vincular sua conta TikTok para habilitar a publicação direta.
      Conexões existentes continuarão com o método indireto e exigirão o app mobile do TikTok
      para publicar.
    </li>
  </ul>
</Update>

<Update label="17 de Fevereiro, 2023">
  <ul class="custom-bullets">
    <li>
      O Google Perfil da Empresa mudou os dados de análise social disponíveis. Os novos
      campos disponíveis são os seguintes. Campos anteriores ainda estarão presentes, mas com valor zero
      e serão totalmente removidos em 17 de março de 2023.
    </li>
  </ul>
</Update>

<Update label="1 de Outubro, 2022">
  <ul class="custom-bullets">
    <li>Descrições, texto e campos de mensagem do Get All Posts padronizados para o campo `post`.</li>
  </ul>
</Update>

<Update label="12 de Setembro, 2022">
  <ul class="custom-bullets">
    <li>Campos descontinuados do TikTok: `shareUrl`. Use `postUrl`.</li>
  </ul>
</Update>

<Update label="17 de Junho, 2022">
  <ul class="custom-bullets">
    <li>
      Para todos os endpoints history, os campos `createdAt`, `createdTime` e `timestamp` serão
      substituídos pelo campo `created` que retorna o tempo de criação em formato UTC.
    </li>

    <li>
      O campo `scheduleDate` não retornará mais um Objeto e sim uma String contendo o horário agendado
      em formato UTC.
    </li>

    <li>
      O campo não documentado `created_date` em /history será removido. Use `created` em vez disso.
    </li>
  </ul>
</Update>

<Update label="22 de Abril, 2022">
  <ul class="custom-bullets">
    <li>
      Analytics em um [post do Facebook](/apis/analytics/post) retorna `reactions` como um objeto no
      seguinte formato.
    </li>
  </ul>
</Update>

<Update label="1 de Abril, 2022">
  <ul class="custom-bullets">
    <li>
      O History por padrão retornará os últimos 20 posts. Até 500 podem ser retornados com o
      parâmetro `lastRecords`.
    </li>
  </ul>
</Update>