> ## 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. # Últimas Atualizações > Veja as novidades na Ayrshare. Confira nosso changelog com novos e ótimos recursos. [Siga-nos no X](https://twitter.com/intent/user?screen_name=ayrshare), ouça nosso [Podcast Social Media API](https://ayrshare.podbean.com/) ou inscreva-se em nosso [Newsletter](https://dashboard.mailerlite.com/forms/42719/54642298519029076/share) para as últimas atualizações. ## Julho de 2026

8 de julho - Tempos de Resposta da API Mais Rápidos. Lançamos uma rodada de trabalho de performance no backend que reduz significativamente a latência em alguns dos nossos endpoints mais populares. Os tempos de resposta médio e no percentil 95 (p95) caíram substancialmente, com os maiores ganhos aparecendo sob carga pesada. Os maiores ganhos são em profiles e analytics. Nenhuma mudança de API é necessária; toda requisição agora é mais rápida automaticamente. | Endpoint | Avg mais rápido | p95 mais rápido | | ---------------- | --------------- | --------------- | | `GET /profiles` | **-71.6%** | **-88.7%** | | `GET /analytics` | **-59.5%** | **-75.0%** | | `GET /user` | **-51.0%** | **-48.6%** | | `GET /post` | **-47.6%** | **-63.1%** | | `GET /messages` | **-40.5%** | **-59.4%** |
7 de julho - Método de Vinculação do Instagram Por Sessão em generateJWT. O endpoint generateJWT agora aceita um parâmetro de corpo opcional instagramLinkMethod que sobrepõe sua configuração global de Instagram Login para uma única sessão de vinculação. Envie "instagram" para iniciar o Instagram Login direto (sem Página do Facebook obrigatória) ou "facebook" para vincular via uma Página do Facebook conectada quando o usuário clicar no botão Instagram na página de vinculação social. A sobreposição se aplica apenas à página de vinculação aberta a partir da URL JWT retornada — persiste durante o redirecionamento de autorização mas nunca altera sua configuração global e omitir o parâmetro mantém o comportamento existente. Valores inválidos retornam 400 listando as opções válidas. Consulte a nova seção Instagram Link Method para detalhes, incluindo as diferenças de recursos entre os dois fluxos.

## Junho de 2026

24 de junho - Integração com n8n. Conecte o n8n ao Servidor MCP Ayrshare usando o nó MCP Client Tool integrado do n8n, sem código customizado e sem nó da comunidade para instalar. Veja a nova página de integração com n8n para uma visão geral, e o guia completo do n8n para configuração, três exemplos trabalhados, perfis multi-tenant, X BYO e um workflow inicial para download (Chat Trigger para AI Agent para o nó MCP Ayrshare). Consulte também Connect & Setup e o Catálogo de Ferramentas.
17 de junho - Análises do Facebook: Meta Descontinuou Métricas de Alcance e Vídeo de 3 Segundos. A Meta removeu as métricas Insights de impressões únicas e visualização de vídeo de 3 segundos em todas as versões da Graph API (a partir de 15 de junho de 2026). As análises de posts do Facebook não retornam mais impressionsUnique, impressionsFanUnique, impressionsOrganicUnique, impressionsPaidUnique ou videoViewsUnique, e as análises sociais não retornam mais a família pagePostsImpressions\* (incluindo pagePostsServedImpressionsOrganicUnique). Os campos ainda suportados (reactionsByType, videoViews, mediaView, pagePostEngagements, pageVideoViews) não são afetados. Use mediaView / pageMediaView para alcance; um sucessor Total Unique Media Views está planejado. Referência: changelog da Meta Graph API v25.
15 de junho - Código de Erro 476 de Restrição de Conta do Facebook. Posts do Facebook que falham porque a Meta colocou uma restrição na conta (subcódigos Meta 2424009 e 1404078, ou o texto de restrição da Meta quando não há subcódigo presente) agora retornam um dedicado, não-retriável code: 476 (HTTP 400) em vez do genérico retriável code: 108. A conta permanece vinculada — resolva a restrição pela página Account Status da Meta (Facebook → foto do perfil → Help → Account Status), que exibe o motivo específico e um fluxo de apelação que a API não pode retornar. Consulte Restrição de Conta do Facebook para detalhes.
10 de junho - Análises de Perfil Pessoal do LinkedIn. Perfis pessoais (membros) do LinkedIn agora retornam uma matriz expandida de análises. As análises de posts incluem impressionCount, uniqueImpressionsCount (membros alcançados), likeCount, commentCount, shareCount, engagement, reactions, e — para posts de vídeo — videoViews, videoViewers, e videoWatchTimeMs. As análises sociais adicionam followersCount vitalício, crescimento diário followersDaily, e métricas agregadas de post. Contagens agregadas de reshare/reação/comentário são best-effort e podem diferir ligeiramente da UI do LinkedIn. Contas vinculadas existentes precisam re-vincular seu perfil do LinkedIn na página Social Accounts para conceder os novos escopos de análises — até que isso seja feito, as análises retornam code: 475 ("re-link your LinkedIn profile to enable analytics"). A publicação não é afetada.
10 de junho - Primeiros Comentários do TikTok Agora Orientados por Evento. Um primeiro comentário em um post do TikTok não é mais tentado em uma espera fixa por tempo. Como o TikTok processa vídeos de forma assíncrona, a resposta /post agora retorna o primeiro comentário do TikTok com status: "pending", e o comentário é postado automaticamente uma vez que o TikTok termina o processamento e o webhook tikTokPublished resolve o id real do vídeo. A visibility do vídeo deve ser public, caso contrário um erro claro de comentário é retornado. Separadamente, get-comments em um post do TikTok ainda em processamento agora retorna code: 288 em vez de uma falha genérica.
8 de junho - Falhas de Miniatura do YouTube Agora Expostas. Quando um vídeo do YouTube é publicado mas sua miniatura personalizada falha ao aplicar, o resultado do YouTube agora mantém status: "success" (o vídeo permanece ao vivo) e adiciona um array warnings (feature: "thumbnail", code: 307) descrevendo a falha — anteriormente a falha era enterrada no sub-objeto thumbNail, que ainda é retido para compatibilidade retroativa. A orientação enganosa 403 foi corrigida para começar com **verificação de telefone do canal** em [https://www.youtube.com/verify](https://www.youtube.com/verify) (um canal não verificado é a causa dominante), com re-vinculação OAuth como uma etapa secundária. Nova **validação pré-publicação** também captura miniaturas que não são PNG/JPG, têm mais de 2MB ou estão inacessíveis antes do upload e as ignora, de forma que o vídeo ainda é publicado com o motivo relatado em `warnings` (um problema de miniatura nunca falha o post). Consulte a [YouTube Post API](/apis/post/social-networks/youtube#youtube-thumbnails) e o novo guia de solução de problemas [YouTube Thumbnail Not Applied (Unverified Channel)](/help-center/technical-support/youtube_thumbnail_unverified_channel).
8 de junho - Análises X BYOK Agora Retornam Código 416 em Créditos Esgotados. Quando a conta do X Developer inscrita de uma conta X/Twitter BYOK fica sem créditos de API, os caminhos de analytics e user-lookup agora retornam code: 416 (HTTP 402, X CreditsDepleted) com o id da conta inscrita no detail — anteriormente estes eram mascarados como code: 294 (HTTP 400, "Unable to get X User"). A correção é adicionar créditos no X Developer Portal. Isso alinha a superfície analytics/lookup com o caminho de publicação (que já retorna 416). Se sua integração se ramifica em 294 das análises para detectar um handle inválido, adicione tratamento para 416.
4 de junho - Servidor MCP & plugin Claude Code. Agentes de IA agora podem operar a API Ayrshare através do novo Servidor MCP ([https://api.ayrshare.com/mcp](https://api.ayrshare.com/mcp)), incluindo o plugin Claude Code. Consulte Connect & Setup e o Catálogo de Ferramentas. O MCP de busca em docs existente agora é Documentation MCP.

## Maio de 2026

22 de maio - Correção de Roteamento por Profile-Key no Bulk Post. POST /post/bulk agora respeita o cabeçalho Profile-Key, de forma que linhas CSV publiquem no Perfil de Usuário resolvido em vez do Perfil Primário. Anteriormente uploads em massa enviados com Profile-Key eram silenciosamente roteados para as contas sociais do Perfil Primário. Consulte Bulk Post.
21 de maio - Escopo DELETE /comments do TikTok esclarecido. Atualizamos as páginas [Delete Comments](/apis/comments/delete-comments) e [Comments Overview](/apis/comments/overview) para documentar que DELETE /comments no TikTok só é bem-sucedido para comentários criados pela própria conta TikTok autenticada (suas próprias respostas). Tentar excluir um comentário de terceiros retorna Ayrshare code: 328. Clientes que precisam moderar comentários de terceiros em seus próprios vídeos do TikTok devem entrar em contato com o suporte. Sem mudança de comportamento na API; apenas documentação.
21 de maio - Ocultar Comentários do TikTok. DELETE /comments agora suporta ocultar um comentário do TikTok de espectadores públicos via hide=true junto com videoId. A resposta de sucesso retorna action: "hide" e retorna o texto do comentário; enviar hide=true sem videoId é rejeitado com um 400. Comentários ocultos permanecem visíveis para o dono do vídeo no TikTok Studio.
20 de maio - Node SDK v1.3.0 — Suporte X/Twitter BYO. O Node SDK oficial agora expõe setTwitterByo(apiKey, apiSecret) e clearTwitterByo() para X/Twitter Bring-Your-Own-Keys. Uma vez definido, cada requisição do SDK inclui os cabeçalhos X-Twitter-OAuth1-Api-Key e X-Twitter-OAuth1-Api-Secret obrigatórios — necessários para operações X/Twitter agora que a exigência BYO da Ayrshare é aplicada (a partir de 31 de março de 2026). Instale via npm install social-media-api\@1.3.0; notas da versão em npm e GitHub.
20 de maio - Preços Medidos para Mensagens. Business Messaging agora é cobrado via preços medidos do Stripe a $0.09 por conversa ativa nos planos Launch e Business (o Premium permanece um add-on fixo de $49/mês), com até 1.000 conversas ativas por ciclo de faturamento. Consulte preços de Mensagens.
20 de maio - Análises do Instagram Não Desvinculam Mais em Erros de Permissão. Quando as análises do Instagram encontram um erro de permissão faltante (Meta errCode 10), a conta não é mais desvinculada automaticamente. Anteriormente, um problema de escopo/permissão era tratado como um token revogado e desconectava silenciosamente a conta mesmo quando a publicação ainda funcionava. A Ayrshare agora mantém a conta vinculada e expõe um erro de escopo de permissão em vez disso.
19 de maio - hideLogo por perfil. Novo booleano hideLogo em [Create Profile](/apis/profiles/create-profile) e [Update Profile](/apis/profiles/update-profile) oculta o logotipo global na página de vinculação social de um Perfil de Usuário individual. Útil para white-label de perfis individuais de parceiros.
19 de maio - Compartilhamento de Orçamento do Facebook Boost Ad Set. O [endpoint Boost](/apis/ads/facebook/boost-post) agora aceita um novo booleano opcional adSetBudgetSharingEnabled (padrão false). A Meta agora exige este campo wire em cada campanha criada sem orçamento de nível de campanha, e a Ayrshare o envia em cada requisição — o padrão false preserva o comportamento anterior sem alterações no chamador. Defina-o como true para habilitar a otimização cross-ad-set da Meta, que pode transferir até \~20% do orçamento de um ad set para outros ad sets na mesma campanha para melhor desempenho geral.
19 de maio - Erro de Subreddit Banido no Reddit. Publicar em um subreddit do qual você está banido agora retorna um erro distinto, não-retriável seguro, em vez do genérico retriável seguro code 121. Isso impede que agendadores tentem novamente em loop um post permanentemente rejeitado. Consulte códigos de erro Ayrshare.
19 de maio - Limite de Tamanho de Vídeo do Bluesky. O tamanho máximo de upload de vídeo no Bluesky agora é 100 MB (anteriormente anunciado como 1 GB) para corresponder ao limite da plataforma Bluesky. Arquivos acima de 100 MB agora são rejeitados antecipadamente em vez de falharem no upload. Consulte as diretrizes de mídia do Bluesky.
19 de maio - Mensagens X/Twitter no Dashboard para Chaves BYO. A página Messaging do dashboard Ayrshare agora suporta mensagens diretas do X/Twitter para contas Bring-Your-Own-Keys (BYO). Sua consumer key e secret do X são coletadas no navegador para a sessão e passadas por ações de envio, refresh e image-fetch — nenhuma chave é armazenada. Necessário agora que o X/Twitter é BYO-only na Ayrshare.
19 de maio - Correção de Targeting de Cidades para Facebook Ads. O endpoint Facebook Ads Cities (GET /ads/facebook/cities) agora resolve corretamente cidades e seus dados de região associados. Cada resultado inclui region, regionId e supportsRegion para que você possa direcionar a região de uma cidade quando disponível. Use o parâmetro de query search com um nome parcial ou completo de cidade.
18 de maio - Controles de Campo de Status do YouTube. Três novos parâmetros opcionais no YouTube Post API youTubeOptions: license ("youtube" ou "creativeCommon"), embeddable (booleano), e publicStatsViewable (booleano — controla o painel de estatísticas estendidas na página de exibição; contagens básicas de visualização e curtida permanecem públicas independentemente). A resposta /history/youtube agora também retorna esses campos. Dois novos códigos de erro de validação — 455 (license inválido) e 456 (embeddable ou publicStatsViewable inválido) — rejeitam requisições malformadas no edge da Ayrshare. Toggles de monetização (habilitar/desabilitar anúncios) não estão incluídos; esses requerem credenciais YouTube CMS e não estão disponíveis via API padrão do YouTube.
18 de maio - Primeiro Comentário do GMB Não Mascara Mais o Sucesso do Post. Corrigido um problema onde incluir firstComment em um post do Google Perfil da Empresa retornava code: 163 sem postIds mesmo quando o post era bem-sucedido. O Google Perfil da Empresa não suporta comentários de posts, então firstComment agora é ignorado para GMB e o resultado do post bem-sucedido é retornado normalmente.
14 de maio - Prevenindo Desvinculação de Contas. Redes sociais vêm silenciosamente implementando controles anti-bot mais rigorosos, o que estava causando um número anormalmente alto de contas de usuário a serem desvinculadas. Implementamos várias melhorias no backend para reduzir desvinculações e clarificar mensagens de erro, e atualizamos a página de vinculação de contas para tornar a UI muito mais clara para os usuários — incluindo um novo estado "Ação necessária" para redes Meta (Facebook, Instagram, FB Groups, Threads, Messenger) quando uma conta atinge o limbo de verificação de identidade, com um link "Resolver com a Meta" e uma sondagem "Verificar novamente" para que os usuários possam corrigir o problema sem desvincular e re-vincular.
12 de maio - Automações de Engajamento do Instagram (Beta). Nova Automations API permite que seus usuários reajam automaticamente ao engajamento no Instagram — dispare um DM, webhook ou e-mail quando um usuário final comenta em um post, responde a um story, envia um DM ou reage a um DM. Quatro tipos de trigger (comment\_keyword, story\_reply, dm\_reaction, dm\_keyword) e três tipos de ação (send\_dm, fire\_webhook, send\_email) — até 50 de cada por regra. Inclui dedupe de 7 dias por ação (configurável por ação via dedupWindowMinutes), limites diários de DM (1.000 Business / 5.000 Enterprise), e um log de atividade paginado por cursor. Disponível nos planos Business e Enterprise. Novos códigos de erro 462–472 cobrem validação, gating de tier, o limite de automation ativa, contas vinculadas faltantes, e opt-in de feature flag. Beta — estamos ativamente coletando feedback; envie relatos de bugs e pedidos de recursos ao suporte.
12 de maio - Melhorias no Throughput de Posts Agendados. Adicionamos mais hardware para processar posts agendados o que está aumentando dramaticamente throughput e desempenho. Também adicionaremos hardware específico para YouTube e TikTok em breve.
12 de maio - Dica de Relink do Instagram para Erros de Estado de Conta. Certas falhas de estado de conta do Instagram (Meta error\_subcode 2207085, anteriormente exibidas como um genérico code: 258 sem orientação) agora retornam relink: true e retryAvailable: true com uma mensagem de remediação instruindo o usuário a desvincular e re-vincular a conta do Instagram concedendo todas as permissões. Consulte [códigos de erro](/errors/errors-ayrshare).
11 de maio - Códigos de erro transientes do YouTube. Uploads no YouTube que falham devido a problemas transientes upstream agora retornam novos códigos de erro 453 (HTTP 504, timeout de ingestão do Google) e 454 (HTTP 503, serviço indisponível) com uma flag retryAvailable: true que sua integração pode usar para tentar novamente automaticamente. Consulte [códigos de erro](/errors/errors-ayrshare) para detalhes.
11 de maio - Analytics e Lookups do X/Twitter Abertos a Todos os Usuários BYO. O gate legado do add-on do X foi removido de /analytics/social e /lookups/x. Qualquer cliente X/Twitter Bring-Your-Own-Keys agora pode consultar análises para handles arbitrários e usar o endpoint de lookups do X sem receber code: 3. As chamadas são assinadas com suas próprias credenciais de App X Developer e contam contra seus próprios limites de taxa do X.
8 de maio - Python SDK v1.3.0 — Suporte X/Twitter BYO. O Python SDK oficial agora expõe set\_twitter\_byo(api\_key, api\_secret) e clear\_twitter\_byo() para X/Twitter Bring-Your-Own-Keys. Uma vez definido, cada requisição do SDK inclui os cabeçalhos X-Twitter-OAuth1-Api-Key e X-Twitter-OAuth1-Api-Secret obrigatórios — necessários para operações X/Twitter agora que a exigência BYO da Ayrshare é aplicada (a partir de 31 de março de 2026). Instale via pip install --upgrade social-post-api; notas da versão em GitHub e PyPI.
4 de maio - Conversão Automática de Formato de Imagem. Imagens WebP, HEIC e AVIF agora são convertidas automaticamente para JPEG antes de serem publicadas em plataformas que não as aceitam. A conversão de WebP se aplica a Instagram, LinkedIn, TikTok, Google Meu Negócio, Threads e Snapchat. HEIC e AVIF são convertidos em todas as plataformas suportadas. Nenhuma alteração na API é necessária; a conversão ocorre transparentemente no momento do envio. Novos códigos de erro 450 (falha na conversão), 451 (falha no download da origem) e 452 (falha no upload da imagem convertida) aparecem quando a conversão não pode ser concluída.
4 de maio - Erros do Instagram agora incluem mensagem bruta da Meta. Falhas de media-status do Instagram agora expõem o texto subjacente do erro da Meta no campo details junto com o código de erro Ayrshare, para que os chamadores possam distinguir causas (por exemplo, problemas de robots.txt/crawler vs. problemas de token) sem adivinhar pelo código genérico. Consulte a [Instagram Post API](/apis/post/social-networks/instagram) e [códigos de erro](/errors/errors-ayrshare).

## Abril de 2026

30 de abril - X/Twitter BYOK no API Explorer. O Ayrshare API Explorer agora inclui uma seção colapsável X/Twitter BYOK (Bring Your Own Keys) para que você possa colar sua API Key e API Secret do X uma vez e tê-las anexadas como cabeçalhos X-Twitter-OAuth1-Api-Key e X-Twitter-OAuth1-Api-Secret em cada requisição de saída — não é mais necessário recorrer a curl ou Postman para testar BYOK a partir do Explorer. Valores são limitados à aba atual do navegador via sessionStorage, mascarados por padrão com um toggle de reveal, e limpos com um clique. Consulte o Guia de Configuração de Chaves X BYO para saber como obter suas credenciais.
28 de abril - Aprimoramentos de Análises Sociais (em rollout). O endpoint Social Analytics está ganhando o Instagram shareCount (compartilhamentos totais agregados na janela rolante de 90 dias) e YouTube lifetimeLikes (opt-in via youtube: \{ lifetime: true }); os novos campos aparecerão nas respostas conforme o deployment alcança sua conta. Correções de documentação incluídas nesta atualização: Instagram viewsCount é uma janela rolante de 90 dias (não 180 dias), mediaCount é sempre vitalício, YouTube likes é escopo por quarters, e métricas de nível de perfil TikTok são limitadas a 60 dias com semântica vitalícia por post quando quarters é usado.
28 de abril - Trial Reels do Instagram. O endpoint /post agora suporta a publicação de Trial Reels do Instagram — Reels visíveis apenas para não-seguidores quando publicados pela primeira vez. Defina instagramOptions.trialParams.graduationStrategy como "MANUAL" (graduar de dentro do app Instagram) ou "SS\_PERFORMANCE" (Meta gradua automaticamente com base no desempenho inicial). Três novos códigos de erro de validação — 447, 448, 449 — rejeitam requisições inválidas de trial-reel no edge da Ayrshare.
24 de abril - Confiabilidade de Publicação no Instagram. Expandimos o tratamento automatizado de retry para o Instagram durante horários de pico e melhoramos mensagens de erro em geral. Em vez de erros genéricos, você agora receberá códigos de erro específicos para rate limits (code: 435) e timeouts de processamento de mídia (code: 436) — facilitando o diagnóstico de problemas e a construção de lógica de retry mais inteligente em suas integrações.
23 de abril - Código de Erro 444 de Rate Limit em Análises do Facebook. Throttles por Página nas análises da Página do Facebook (erro Meta 80001) agora retornam code: 444 (HTTP 429) em respostas de análises de post e social. Anteriormente esses throttles eram mal classificados como code: 161 ("relink your account"). Se sua integração se ramifica em 161 para acionar um fluxo de relink, atualize-a para reconhecer 444 e tente novamente com backoff. Consulte Facebook Analytics Rate Limit para detalhes.
23 de abril - Solução de Problemas para o Crawler de Mídia da Meta. Novo guia do help-center sobre como corrigir o erro code: 440 ("social network could not download media from this URL") e os relacionados Instagram code: 138 / Threads code: 379, todos causados por robots.txt ou regras de bot bloqueando o crawler de publicação da Meta. Consulte Meta Media Crawler Blocked.
21 de abril - Erros de input de moderação agora retornam 400. POST /validate/moderation agora retorna o novo erro code 438 (HTTP 400) para problemas de input do chamador (por exemplo, um arquivo não suportado como imageUrl, ou uma URL inacessível/malformada) em vez de um enganoso 500 com orientação de retry. Falhas de processamento genuínas ainda retornam code 331 (HTTP 500). Consulte [códigos de erro](/errors/errors-ayrshare).
20 de abril - Código de Erro 441 de Aprimoramento de Caption. O endpoint Post agora retorna o erro code: 441 (HTTP 502) quando um aprimoramento de caption como shortenLinks falha. Quando a falha afeta apenas algumas plataformas, as plataformas bem-sucedidas ainda publicam e aparecem em postIds junto com um status: "error" no topo e entradas por plataforma em errors\[]. Consulte Caption Enhancement Errors para detalhes.
15 de abril - Detecção de token morto do Instagram. Posts do Instagram que falham devido a um token OAuth inválido/expirado — ou a um erro de função/permissão de página (Meta subcode 492) — agora retornam Ayrshare code 161 (erro de autorização) e desvinculam automaticamente a conta afetada para que o usuário seja notificado a re-vincular, em vez da enganosa resposta genérica code 138 "please try again" que anteriormente mascarava esses casos. Consulte [códigos de erro](/errors/errors-ayrshare) e a [Instagram Post API](/apis/post/social-networks/instagram).
9 de abril - Dados All-Time e Filtragem por Data em Análises do Instagram e TikTok. O endpoint social analytics agora retorna dados all-time do Instagram e TikTok quando nem daily nem quarters é especificado. Use quarters (1–4, onde 1 = 90 dias) ou daily=true para filtrar por intervalo de datas — agora também suportado no TikTok. Quando ativo, os rótulos e totais de período para comentários, compartilhamentos e visualizações do TikTok refletem o intervalo de datas filtrado.
9 de abril - Confiabilidade e Recuperação de Análises. Os endpoints Social Analytics e Post Analytics agora fazem backfill automático de métricas cumulativas (seguidores, curtidas, visualizações) a partir de dados armazenados quando a rede social retorna zeros temporariamente. Dois novos campos opcionais de resposta, backfilledFrom e recoveredFrom, indicam quando dados armazenados foram usados. Adicionalmente, solicitar análises quando nenhuma plataforma retorna dados agora retorna um erro 400 (code: 187) em vez de uma resposta de sucesso vazia.
1 de abril - Credenciais X Baseadas em Header no generateJWT. O endpoint Generate JWT agora aceita os cabeçalhos X-Twitter-OAuth1-Api-Key e X-Twitter-OAuth1-Api-Secret para passar suas consumer keys do X — consistente com todos os outros endpoints X/Twitter. Parâmetros de corpo permanecem suportados para compatibilidade retroativa.

## Março de 2026

30 de março - Erros de Créditos Esgotados do X Expostos. Quando uma conta X/Twitter Developer BYOK fica sem créditos de API, os posts que anteriormente ficavam presos em processing sem erro agora corretamente falham com code: 416 (X Credits Depleted, HTTP 402). A detecção para code: 416 foi ampliada para também capturar respostas HTTP 429 do X que mencionam créditos. Consulte códigos de erro para detalhes.
28 de março - Resposta Nula em Post do Instagram Corrigida. Resolvido um caso extremo onde um post do Instagram era bem-sucedido na plataforma mas a resposta /post retornava null em vez do corpo normal de sucesso com postIds e id. Posts bem-sucedidos do Instagram agora sempre retornam uma resposta válida que sua integração pode fazer parse.
26 de março - Correção de Alcance Diário do Instagram. Corrigido um problema onde as Social Analytics do Instagram omitiam dados de alcance diário quando daily=true era definido. A resposta agora retorna um objeto reach aninhado (com period e uma série temporal values) no modo diário; o escalar reachCount ainda é retornado no modo não-diário e é preservado como fallback quando os dados diários estão temporariamente indisponíveis.
26 de março - Códigos de Erro de Aplicação BYOK do X/Twitter. Com o requisito [Bring Your Own Keys](/dashboard/connect-social-accounts/x-twitter-byo-keys) agora aplicado, as requisições X/Twitter retornam códigos de erro específicos nos quais você pode se ramificar: 419 (HTTP 400, cabeçalhos X-Twitter-OAuth1-Api-Key/Secret ausentes), 416 (HTTP 402, conta X Developer sem créditos), e 417 (HTTP 403, permissões do app OAuth 1.0a não definidas como Read/Write/DM). Consulte códigos de erro para mensagens e resoluções.
23 de março - Busca por Palavra-Chave no X. Novo endpoint de busca por palavra-chave para clientes BYOK. Busque tweets no X/Twitter que correspondam a palavras-chave, hashtags e operadores de busca avançados. Suporta paginação, filtragem por idioma e localização, e retorna dados normalizados de tweets.
23 de março - Seção Listening. Uma nova seção Listening foi adicionada, expandindo os endpoints Brand com novos recursos como busca por palavra-chave.
19 de março - @Menções em Comentários. Adicionamos documentação para suporte a @menção na string de texto comment nos endpoints [Post a Comment](/apis/comments/post-comment) e [Reply to a Comment](/apis/comments/reply-to-comment). Inclui detalhes de resolução server-side do LinkedIn e links para sintaxe de menção específica por plataforma.
Mensagens Paginadas do X/Twitter. O endpoint [Get Messages](/apis/messages/get-messages) agora suporta um parâmetro de query limit para X/Twitter, permitindo buscar apenas as N mensagens mais recentes (1–100) sem uma sincronização de histórico completa. Combinado com paginação por cursor via o parâmetro next, isso permite polling eficiente — busque um pequeno lote, verifique se você já os tem e só pagine mais se necessário.
Limites de Tamanho de Vídeo Aumentados. Com tanto da publicação social agora focada em conteúdo de vídeo, aumentamos nossos limites de upload de vídeo em várias plataformas: LinkedIn (200 MB → 500 MB), TikTok (1 GB → 10 GB), X Premium vídeo longo (1 GB → 16 GB), e adicionamos limites maiores específicos por content-type para Facebook (Reels 2 GB, Stories 4 GB, Feed 10 GB) e Pinterest (2 GB). Consulte as [Diretrizes de Mídia](/media-guidelines/overview) para detalhes completos.
Suporte a Chaves BYO em Mensagens do X/Twitter. Os endpoints [Get Messages](/apis/messages/get-messages) e [Send Message](/apis/messages/send-message) agora suportam credenciais BYO (Bring Your Own) da API do X/Twitter. Notificações em tempo real de DMs via webhooks não estão disponíveis para usuários BYO; use polling via o endpoint GET Messages em vez disso.
Bring Your Own Keys no X. Uma grande mudança em como as contas do X/Twitter são conectadas. A nova abordagem [Bring Your Own Keys](/apis/post/social-networks/x-twitter) oferece mais controle da sua conta, melhor portabilidade de dados e um fluxo OAuth com marca personalizada. Todos os usuários precisam fazer a transição até 31 de março de 2026.
Links Curtos Editáveis. Agora você pode [atualizar links curtos](/apis/links/update-short-link) após serem publicados.
Confiabilidade do Processamento de Posts Agendados. Resolvido um problema onde o job de processamento de posts agendados podia ficar sem memória e retornar erros 503. Aumentamos a alocação de recursos, adicionamos processamento paginado de queries e introduzimos um application lock distribuído para evitar execução duplicada — garantindo execuções únicas e confiáveis para todo o processamento de posts agendados.
Melhorias no Histórico do Facebook e Instagram. Melhoramos os endpoints [/history/facebook](/apis/history/history-platform) e [/history/instagram](/apis/history/history-platform): para o Facebook, Stories expirados/arquivados são agora filtrados por padrão para que apenas Stories ativos apareçam ao lado de posts regulares, e novos parâmetros de query since e until permitem filtragem baseada em tempo com strings de data ISO UTC. Para Facebook e Instagram, um novo parâmetro dataType permite requisitar apenas posts, apenas stories, ou ambos (padrão).
Limites de Taxa do X Removidos. Como parte da [migração para Chaves BYO do X/Twitter](/dashboard/connect-social-accounts/x-twitter-byo-keys), a Ayrshare não aplica mais limites mensais ou diários em análises do X. Seu uso agora é governado pelos limites da sua própria conta X Developer.

## Fevereiro de 2026

25 de fevereiro - Títulos e Descrições de Vídeo do X/Twitter. Vídeos publicados no X/Twitter agora suportam a configuração de videoTitle e videoDescription (enviados no objeto twitterOptions do X Post API) para mídia enviada ao X Media Studio. Estes acompanham o suporte existente a thumbNail para metadados de vídeo mais ricos.
Análises em Lote. Adicionado suporte para análises em lote de IDs de posts sociais, permitindo até 100 posts por chamada de analytics usando o novo parâmetro postIds. Leia sobre isso no nosso endpoint [Analytics on a Post by Social ID](/apis/analytics/social-by-id).
Paginação de Histórico. Adicionado suporte a paginação à API de [histórico de posts por plataforma](/apis/history/history-platform) para Threads e X/Twitter. Sem mais limite de 500 posts — você pode agora puxar um histórico mais longo usando paginação e dividir chamadas em pedaços menores para respostas mais rápidas e eficientes.
Aprimoramentos do Free Trial. Usuários do free trial agora podem testar a [Messaging API](/apis/messages/overview) e o [Max Pack](/additional/maxpack) — você não será cobrado até o final do período de free trial.
Mensagens de Erro Melhoradas. Adicionamos detalhes adicionais às mensagens de erro do [X/Twitter](/apis/post/social-networks/x-twitter) e [LinkedIn](/apis/post/social-networks/linkedin), facilitando o diagnóstico de problemas com suas chamadas de API.
Correção de Comentários do Instagram. Corrigido um problema onde comentários de nível superior do Instagram com respostas aninhadas não estavam sendo retornados corretamente pelo endpoint [Get Comments](/apis/comments/get-comments).
Python SDK. Atualizamos nosso [Python SDK](https://pypi.org/project/social-post-api/) com os últimos recursos e melhorias.
URL de Webhook do X/Twitter. Um novo campo ayrshareUrl agora está incluído no payload do [webhook Direct Message Event](/apis/webhooks/actions#direct-message-event), fornecendo uma URL não autenticada para conveniência.
Integração do Slack com a Status Page. Você pode vincular atualizações da nossa [Status Page](https://status.ayrshare.com) automaticamente no Slack. Basta clicar em "Get Updates" no canto superior direito e selecionar a opção Slack.

## Janeiro de 2026

21 de janeiro - Correção de Domínio Personalizado em Link Analytics. O endpoint [Link Analytics](/apis/links/link-analytics) (GET /links/:id) agora retorna links curtos usando seu domínio personalizado configurado em vez do domínio Ayrshare padrão. Se você usa um domínio de link curto personalizado (Business/Enterprise), as URLs de analytics agora correspondem aos seus links ao vivo.
15 de janeiro - Sincronização de Exclusão de Mensagens Enviadas do Instagram. Quando uma mensagem enviada do Instagram é deletada no app nativo do Instagram, ela agora é corretamente marcada como deletada nos dados de [Messages](/apis/messages/get-messages) da Ayrshare — combinando o comportamento existente para mensagens de entrada. O histórico de conversa agora permanece preciso para ambas as direções.
MCP Server. A pedidos populares — relançamos nosso [MCP Server](/additional/mcp-server)! Conecte suas ferramentas de IA diretamente à API Ayrshare.
Cadastro Self-Serve. Adicionamos um novo [cadastro self-serve](https://www.ayrshare.com/pricing/) para o Plano Business e Plano Launch. Novos clientes agora podem acessar um free trial de 14 dias do Plano Launch para testar a plataforma Ayrshare.
Miniaturas de Vídeo do X/Twitter. [Posts de vídeo do X/Twitter](/apis/post/social-networks/x-twitter#video-thumbnail) agora suportam incluir uma imagem de prévia como miniatura (como URL). Isso é enviado como parte dos metadados ao fazer upload de um vídeo.
Limite de Hashtags do Instagram. Alterado o limite de hashtags nos [posts do Instagram](/apis/post/social-networks/instagram) para 5 para alinhar com novas diretrizes publicadas pelo Instagram.
Duração de Vídeo do Bluesky. O limite de duração de mídia de vídeo do Bluesky foi ajustado para [três minutos](/media-guidelines/bluesky#video) para estar em linha com os requisitos da API Bluesky.

## Dezembro de 2025 Estamos encerrando este ano focados em transparência e confiabilidade, com toneladas de novos lançamentos de recursos planejados para o Q1 de 2026.

23 de dezembro - Entidades de URL do X/Twitter na Resposta. As respostas de post e [histórico](/apis/history/history-platform) do X/Twitter agora incluem dados de entidade de URL para links no corpo do tweet: um array urls de nível superior carregando os campos brutos do X (display\_url, expanded\_url) mais um objeto entities em camelCase onde os mesmos links aparecem como entities.urls\[].displayUrl / expandedUrl — facilitando a renderização de prévias de link e a detecção de links de saída em sua integração.
Entidades do X/Twitter. Os endpoints [post analytics](/apis/analytics/post) e [platform history](/apis/history/history-platform) para X/Twitter agora retornam entidades parseadas do texto do tweet, incluindo URLs, menções, hashtags e cashtags com suas posições e URLs de exibição.
Análises de Posts do Facebook. Novas métricas adicionadas às [análises de posts do Facebook](/apis/analytics/post) incluindo mediaView, mediaViewIsFromAds e mediaViewIsFromFollowers para substituir [métricas de impressão descontinuadas](/whatsnew/upcoming-api-changes#november-14%2C-2025).
Comentários do Bluesky. Suporte melhorado para [recuperação de comentários do Bluesky](/apis/comments/get-comments) com tratamento adequado de IDs de post e comentário no estilo AT Protocol.
Vinculação do Threads. [Vinculação de contas do Threads](/dashboard/connect-social-accounts/threads) aprimorada para lidar com casos onde os campos de nome ou nome de usuário não estão presentes na conta.
Monitoramento 24/7. Contratamos uma equipe dedicada de DevOps para monitorar a plataforma 24 horas por dia para maior confiabilidade.
Recibos Mensais. Recibos mensais automáticos agora são enviados por e-mail ao titular principal da conta, fornecendo melhor transparência sobre preços e pagamentos.

## Novembro de 2025

Refresh de Token do Instagram. Adicionado refresh automatizado para tokens de vida longa do Instagram para usuários que se vinculam ao Instagram usando login IG direto (sem Página do Facebook).
Atualizações de Análises do Facebook. As [análises de posts do Facebook](/apis/analytics/post) agora retornam métricas de impressão aprimoradas incluindo post\_impressions\_paid\_unique, post\_impressions\_fan\_unique, post\_impressions\_organic\_unique e post\_impressions\_unique.
Insights da Página do Facebook. Novos campos de [análises sociais do Facebook](/apis/analytics/social) adicionados: pageFollows, pageMediaView, pageMediaViewIsFromAds e pageMediaViewIsFromFollowers com suporte para desagregação agregada e diária.
Análises do Instagram. As métricas viewsCount e reachCount das [análises sociais do Instagram](/apis/analytics/social) agora são suportadas com contas de Instagram Login direto e contas vinculadas ao Facebook.
Menções do LinkedIn. Corrigido o tratamento de [menções do LinkedIn](/apis/post/social-networks/linkedin#linkedin-mentions) para distinguir corretamente entre mencionar organizações versus indivíduos.
Melhorias no Dashboard. A página API do [dashboard web Ayrshare](https://app.ayrshare.com) foi refatorada com desempenho melhorado e um cartão de uso de mensagens melhor organizado.
Expansão do Time. Expandindo o time de desenvolvimento para acelerar suporte e desenvolvimento de recursos.

## Outubro de 2025

Ayrshare Adquirida pela Saas.group. A Ayrshare foi adquirida pela Saas.group. O time está se expandindo para entregar desenvolvimento de recursos mais rápido e melhor suporte ao cliente.
Histórico de Webhook. Novo endpoint para [obter histórico de webhook](/apis/webhooks/history) por ação dos últimos 6 meses.
Direcionamento de Localização para Facebook Ads. Além do direcionamento por país, agora você pode [especificar uma região ou cidade](/apis/ads/facebook/boost-post#param-locations) ao impulsionar posts do Facebook.
Miniaturas de Vídeo do LinkedIn. O [endpoint de histórico do LinkedIn](/apis/history/history-platform) agora retorna a thumbnailUrl para posts de vídeo, facilitando a exibição de prévias de vídeo em seu aplicativo.
Análises de Posts do Reddit. A confiabilidade das [análises de posts do Reddit](/apis/analytics/post) foi melhorada com tratamento de autenticação aprimorado para evitar problemas de rate limiting.
Histórico do Instagram. Melhorou o tratamento de grandes conjuntos de resultados no [histórico de posts do Instagram](/apis/history/history-platform) para contas com muitos posts.
Facebook Ads. O [endpoint de histórico do Facebook ads](/apis/ads/facebook/get-ad-history) agora inclui um esclarecimento sobre quais anúncios são retornados com base na estrutura da campanha.
Colaboração no Instagram. Adicionamos documentação esclarecendo que [posts de colaboração aceitos](/apis/history/history-platform) podem não retornar do endpoint de histórico da plataforma devido a limitações da API do Instagram.

## Setembro de 2025