Como o limite de links da API do Threads conta as URLs de um post

O que é o limite de links da API do Threads?

O limite de links da API do Threads, definido pela Meta, permite 5 URLs únicas por post, e desde 22 de dezembro de 2025 um contêiner de mídia com uma sexta falha na criação com o código de erro THREADS_API__LINK_LIMIT_EXCEEDED. A regra está em Links, no guia de posts do Threads da Meta, como um item de uma linha, "The number of links is restricted to 5 or less," seguido de uma caixa de aviso:

Starting December 22, 2025, Threads posts containing more than 5 links will fail to post during the media creation step (POST /{threads-user-id}/threads) with the error code: THREADS_API__LINK_LIMIT_EXCEEDED.

O changelog do Threads anunciou a mudança em 8 de dezembro de 2025 e registrou de novo em 22 de dezembro de 2025, com a mesma frase: "Threads posts with more than 5 links will fail to post with the error THREADS_API__LINK_LIMIT_EXCEEDED."

É o único limite de post na documentação do Threads com uma string de erro própria. O teto de 500 caracteres em text não tem nenhuma, como explicado em como o limite de 500 caracteres da API do Threads trata as tags de tópico.

Como a Meta conta os links em um post do Threads?

A Meta conta URLs únicas no campo text e no parâmetro link_attachment juntos. O guia de posts dá três regras:

1. "All unique URLs found in the text field are counted as links."
2. "If the link_attachment field contains a URL that is different from all URLs in the text field, it is counted as an additional link."
3. "If the link_attachment URL is the same as any URL in the text field, it is only counted once, rather than twice."

A Meta então resolve três exemplos, reproduzidos aqui como foram escritos:

A terceira linha é a útil. Quatro menções de URL produzem uma contagem de 2, porque as repetições se fundem e o anexo bate com uma URL que já está no texto. O inverso é o que pega as pessoas: seis URLs diferentes em uma lista de "recursos" falham mesmo quando o post parece curto.

O que a Meta considera uma URL?

Os exemplos da Meta usam domínios soltos como www.facebook.com, sem https:// na frente. Então o contador não espera um esquema para considerar algo um link, e um domínio digitado em texto corrido soma no total.

Além disso, a Meta fica em silêncio. O guia de posts não diz se http://example.com e https://example.com são uma URL ou duas, se uma barra final ou uma query string cria uma URL nova, nem se um domínio sem www equivale a um com. Os exemplos só repetem uma URL caractere por caractere. Até a Meta documentar a normalização, conte como dois links quaisquer duas strings diferentes, e escreva a mesma URL de forma idêntica em todo lugar em que ela aparece em um post.

Em que ponto do fluxo de publicação o erro aparece?

Na criação do contêiner, que é o primeiro passo. Publicar no Threads leva duas chamadas: POST /{threads-user-id}/threads cria um contêiner de mídia, e POST /{threads-user-id}/threads_publish o transforma em um post ao vivo. A Meta aponta a primeira chamada como o ponto de falha.

Esse posicionamento tem duas consequências. O post nunca chega à etapa de publicação, então nunca toca na cota de 250 publicações, que a Meta aplica em threads_publish. A mecânica dessa cota está em o limite de 250 posts por dia da API do Threads. E nenhum ID de contêiner volta, então não há nada para consultar. Os valores de status de contêiner da página de solução de problemas, como EXPIRED e ERROR, só se aplicam a contêineres que existem, e a lista de mensagens de erro dela cobre só o processamento de vídeo e áudio.

A Meta documenta o erro como uma string de código. Ela não documenta o status HTTP nem um código de erro numérico que o acompanhe, então compare com THREADS_API__LINK_LIMIT_EXCEEDED na resposta, e não com um número.

O limite vale para posts de imagem, vídeo e carrossel?

O texto da Meta deixa isso em aberto. A lista de Limitations em Links começa com "This feature is only available for text-only posts. It will not work with image, video, or carousel posts," e o item dos 5 links é a linha seguinte na mesma lista. O primeiro item descreve link_attachment, que a tabela de parâmetros também restringe: "Can only be used for media_type=TEXT posts."

A caixa de aviso em si diz "Threads posts containing more than 5 links," sem nenhum tipo de mídia associado, e um post de imagem ou vídeo ainda pode levar URLs no text. A Meta não dá exemplo para esse caso. A leitura segura é que 5 URLs únicas é o teto para qualquer tipo de post, já que nada na documentação diz que a legenda de um post de imagem está isenta.

Como os text attachments mudam a contagem?

Os text attachments trazem a própria cópia da regra. A página Text Attachments, que cobre textos longos "with up to 10,000 characters and a link," repete o item dos 5 links, o aviso de 22 de dezembro de 2025 e os mesmos três exemplos, com link_attachment_url dentro do objeto text_attachment no lugar de link_attachment.

Ela acrescenta uma restrição: "If there is already a link attachment in the main post, a link attachment cannot be added in the text attachment." Então um post tem no máximo um link de anexo, em um lugar ou no outro.

A lacuna é o campo plaintext. Ele comporta até 10,000 caracteres, e as regras de contagem da Meta citam só URLs "found in the text field" e a URL do anexo. Elas nunca mencionam URLs escritas dentro de plaintext. A Meta não diz que elas estão isentas, e não diz que elas contam. Mantenha o total de URLs únicas entre text, plaintext e o anexo em 5 ou menos e a dúvida nunca aparece.

Como corrigir THREADS_API__LINK_LIMIT_EXCEEDED?

A instrução da própria Meta tem uma linha: "If you receive this error, reduce the number of unique links in your post to 5 or less." Na prática, isso significa contar antes de chamar a API:

1. Extraia toda URL e todo domínio solto de text, mais link_attachment ou text_attachment.link_attachment_url.
2. Junte as duplicatas exatas.
3. Se restarem mais de 5, corte links ou passe-os para uma resposta, que é criada como um post separado pelo mesmo endpoint com reply_to_id e por isso tem a própria contagem.

Um agendador deve rodar essa verificação quando o post é escrito, não quando ele dispara, porque uma falha às 03:00 é um horário perdido. O mesmo vale para a contagem de caracteres e para a cota diária. Para manter uma fila limpa, veja como agendar posts no Threads. O limite é do Threads, então toda ferramenta de agendamento para Threads trabalha dentro dos mesmos 5.

Perguntas frequentes

O que significa THREADS_API__LINK_LIMIT_EXCEEDED?

Significa que o post tinha mais de 5 links únicos. Desde 22 de dezembro de 2025, a Meta rejeita esses posts na etapa de criação de mídia, POST /{threads-user-id}/threads, e retorna esse código de erro em vez de um ID de contêiner.

O mesmo link duas vezes conta como dois links?

Não. A Meta conta "All unique URLs found in the text field," então uma URL repetida em text conta uma vez. Um link_attachment que bate com uma URL já presente em text "is only counted once, rather than twice."

O link_attachment conta para o limite de 5 links?

Só quando acrescenta uma URL nova. A Meta afirma que um link_attachment diferente de todas as URLs em text "is counted as an additional link," enquanto um que bate com uma URL em text não soma nada à contagem.

Quando o Threads começou a aplicar o limite de links?

Em 22 de dezembro de 2025. A Meta anunciou no changelog do Threads em 8 de dezembro de 2025, e o aviso no guia de posts começa com "Starting December 22, 2025."

Um post que falha pelo limite de links gasta a cota diária de 250 posts?

A Meta aplica o limite de 250 posts em POST /{threads-user-id}/threads_publish, e o erro do limite de links chega antes, na criação do contêiner. Um post rejeitado por excesso de links nunca chega à chamada de publicação.

Posso compartilhar mais de 5 links em uma sequência do Threads?

A Meta conta links por post. Uma resposta é um post separado, criado pelo mesmo endpoint de contêiner com reply_to_id, então distribuir os links entre um post e as respostas mantém cada um abaixo do limite. A Meta não documenta nenhum teto combinado para uma sequência.

Quantos links um post do Threads pode ter?

Um post do Threads aceita 5 URLs únicas. O guia de posts da Meta diz "The number of links is restricted to 5 or less," e um sexto link falha na criação do contêiner com THREADS_API__LINK_LIMIT_EXCEEDED. Uma URL repetida no post conta uma vez.

Um domínio sem https:// conta como link?

Os exemplos da Meta usam domínios sem esquema, como www.facebook.com, e os contam como links. O contador não espera por um esquema. Um domínio escrito no texto soma ao total.

As versões http e https da mesma URL são um link ou dois?

A Meta não informa. O guia só repete URLs caractere por caractere, então trate duas strings diferentes como dois links. Escreva a mesma URL de forma idêntica em todo lugar.

As URLs do plaintext de um text attachment contam para o limite?

A Meta não informa. As regras de contagem citam as URLs do campo text e a URL do anexo, e nunca mencionam plaintext. Mantenha o total de URLs únicas entre text, plaintext e o anexo em 5 ou menos.