Pular para o conteúdo principal
As seguintes mudanças na API entrarão em vigor na data especificada. Revise cuidadosamente para verificar quaisquer mudanças potencialmente disruptivas. Consulte Novidades para todos os novos recursos.
​
15 de Junho, 2026
  • 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 para detalhes.
    • GET analytics/post não retorna mais os seguintes campos do Facebook:
      • impressionsUnique → migre para mediaView
      • impressionsFanUnique → migre para mediaView
      • impressionsOrganicUnique → migre para mediaView
      • impressionsPaidUnique → migre para mediaViewIsFromAds
      • videoViewsUnique → use videoViews para visualizações de 3 segundos não únicas
      • As famílias totalVideoViews*Unique e totalVideoImpressions* (por exemplo, totalVideoViewsOrganicUnique, totalVideoViewsPaidUnique, totalVideoViewsUnique)
    • GET analytics/social não retorna mais os seguintes campos do Facebook:
      • A família pagePostsImpressions* (pagePostsImpressions, pagePostsImpressionsPaid, pagePostsImpressionsUnique, pagePostsImpressionsOrganicUnique, pagePostsImpressionsViral*, pagePostsImpressionsNonviral*) → migre para pageMediaView
      • pagePostsServedImpressionsOrganicUnique → migre para pageMediaView
      • pageVideoViewsUnique → use pageVideoViews para visualizações de 3 segundos não únicas
    • 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.
​
11 de Maio, 2026
  • 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 para detalhes.
​
9 de Abril, 2026
  • Análises Vazias Retornam Erro 187: Solicitar Social Analytics ou Post Analytics 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.
​
31 de Março, 2026
  • 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 para instruções.
  • 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.
  • 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.).
​
14 de Novembro, 2025
  • A partir de 14 de novembro de 2025, o Facebook descontinuará os seguintes campos para GET analytics/social:
    • pageFans
    • pageFansCity
    • pageFansLocale
    • pageFansCountry
    • pageFansAdds
    • pageFanAddsUnique
    • pageFanRemoves
    • pageFanRemovesUnique
    • pageImpressions → migre para pageMediaView
    • pageImpressionsPaidUnique → migre para pageMediaViewIsFromAds
    • pageImpressionsUnique
    • pageImpressionsViral
    • pageImpressionsViralUnique
    • pageImpressionsPaid → migre para pageMediaViewIsFromAds
  • A partir de 14 de novembro de 2025, o Facebook descontinuará os seguintes campos para GET analytics/post:
    • 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).
    • postImpressionsUnique (Reels) → use blueReelsPlayCount para contagem de reproduções de reel ou postVideoViewTime para tempo total de visualização.
​
1 de Setembro, 2025
  • A partir de 1 de setembro de 2025, o endpoint 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.
​
1 de Junho, 2025
  • O endpoint 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:
    • followersCount
    • followingCount
    • tweetCount
    • listedCount
    • mediaCount
  • O Facebook descontinuará os seguintes campos para GET analytics/social:
    • pageVideoViews10S
    • pageVideoViews10SAutoplayed
    • pageVideoViews10SClickToPlay
    • pageVideoViews10SOrganic
    • pageVideoViews10SPaid
    • pageVideoViews10SRepeat
    • pageVideoViews10SUnique
​
7 de Maio, 2025
  • 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.
​
20 de Abril, 2025
  • As seguintes métricas para análises de posts do Instagram serão descontinuadas:REELS:
    • playsCount
    • clipsReplaysCount
    • igReelsAggregatedAllPlaysCount
    FEED/STORY:
    • impressionsCount
  • O endpoint history aplicará cache de 1 minuto se o limit for maior que o valor padrão de 25.
​
1 de Março, 2025
O endpoint get comments para TikTok padronizará os nomes de campos para corresponder a outras redes sociais.
  • O campo replyList será renomeado para replies e profileImage será renomeado para profileImageUrl.
  • Ambos os novos nomes de campo já estão disponíveis e podem ser usados na sua integração.
  • TikTok tem as seguintes atualizações:
    • Endpoint social analytics: 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.
    • Endpoints history platform e post analytics: 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.
​
1 de Fevereiro, 2025
O endpoint /user está mudando como reporta o uso de API:
  • O campo monthlyApiCalls será expandido para contar todas as chamadas de API (posts, comentários, análises, etc.).
  • Para contagens específicas de posts, use o novo campo monthlyPostCount.
  • O campo monthlyApiCallsQuota será descontinuado e substituído pelo novo campo monthlyPostQuota.
​
5 de Janeiro, 2025
  • A Meta está descontinuando o campo videoViews no endpoint de análises de posts do Instagram.
  • Além disso, os campos emailContactsCount, getDirectionClicks, profileViewsCount, textMessageClicks, websiteClicksCount e phoneCallClicksCount serão removidos do endpoint social analytics do Instagram.
  • Esses campos serão removidos em 5 de janeiro de 2025.
​
15 de Dezembro, 2024
  • 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 sobre como usar corretamente uma Profile Key.
​
15 de Novembro, 2024
  • 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.
  • O endpoint history agora retornará respostas como objetos por padrão. O parâmetro objResponse será definido como true automaticamente.
  • 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.
​
7 de Outubro, 2024
  • O endpoint media não retornará mais url_1080. Se você precisar redimensionar uma imagem, consulte o endpoint resize.
​
16 de Setembro, 2024
​
3 de Junho, 2024
  • O novo sistema de encurtador de links substituirá o endpoint shortener, que foi descontinuado pelo Google. O novo encurtador de link requer o add-on Max Pack.
  • 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.
​
22 de Abril, 2024
  • A Meta descontinuará sua API de Grupos do Facebook. Consulte o anúncio.
​
16 de Abril, 2024
  • O Instagram esclareceu o período de tempo do conjunto de dados de seguidores online. Consulte aqui para detalhes.
​
1 de Abril, 2024
  • A resposta padrão de Reply to comment with comment ID 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.
​
25 de Janeiro, 2024
​
8 de Dezembro, 2023
  • 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.
  • 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.
  • No webhook Scheduled Action do TikTok, a String platform será descontinuada. Use o campo array platforms como é feito para outros webhooks Scheduled Action.
  • Os docs de delete comment foram corrigidos para se alinhar com o retorno correto.
  • 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.
  • 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:
​
18 de Outubro, 2023
​
30 de Maio, 2023
  • 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.
​
8 de Maio, 2023
  • Estamos animados em lançar publicação direta no 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.
  • Também estamos introduzindo adicionar, obter e excluir comentários do TikTok + dados analíticos demográficos.
  • 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.
​
17 de Fevereiro, 2023
  • 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.
​
1 de Outubro, 2022
  • Descrições, texto e campos de mensagem do Get All Posts padronizados para o campo post.
​
12 de Setembro, 2022
  • Campos descontinuados do TikTok: shareUrl. Use postUrl.
​
17 de Junho, 2022
  • 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.
  • O campo scheduleDate não retornará mais um Objeto e sim uma String contendo o horário agendado em formato UTC.
  • O campo não documentado created_date em /history será removido. Use created em vez disso.
​
22 de Abril, 2022
  • Analytics em um post do Facebook retorna reactions como um objeto no seguinte formato.
​
1 de Abril, 2022
  • O History por padrão retornará os últimos 20 posts. Até 500 podem ser retornados com o parâmetro lastRecords.