Does Threads have an official API?

Yes. Meta shipped the Threads API in 2024 and it now covers publishing, reading your own posts and profile, replies and moderation, insights, webhooks, keyword search and location tagging. It runs on graph.threads.com or graph.threads.net with OAuth access tokens and granular scopes.

How many posts can I publish per day through the Threads API?

250 published posts within a 24 hour moving period, per Threads profile. Replies get a separate budget of 1,000 per 24 hours and deletions are capped at 100. A carousel counts as one post, not as one post per image.

Is the Threads API free to use?

Meta does not charge for Threads API calls. The cost is in the limits: the post, reply and deletion caps above, plus a call budget of 4800 times your number of impressions with a minimum of 10 impressions, so a profile with no audience gets a small allowance.

Do I need app review to post to Threads with the API?

Not for your own profile. Publishing needs the threads_basic and threads_content_publish scopes, which you can authorize yourself. App review comes into play when your app acts for other people's profiles, which is the same rule as the rest of Meta's platform.

Can I schedule Threads posts with the API?

Not on Meta's side. The API publishes when you call threads_publish , so your own scheduler holds the queue and fires at the right minute, or you use a service that holds it for you. Remember the recommended 30 second wait between creating the container and publishing it.

Guia · APIs de redes sociais para desenvolvedores

API do Threads: publicar e ler pela API oficial

Por Antoine Blanco·10 de setembro de 2026·Atualizado em 14 de setembro de 2026·6 min de leitura

Sim, o Threads tem uma API oficial, e ela é a mais amigável que a Meta oferece. Você publica em duas chamadas, consegue ler seus posts, respostas e insights, e para o seu próprio perfil não existe app review. O limite é de 250 posts publicados e 1.000 respostas a cada 24 horas. Tudo o que vem abaixo vem da documentação do Threads da Meta, lida em 10 de setembro de 2026.

O que a Threads API faz hoje

Segundo a visão geral da Threads API, a API cobre quatro tarefas: criar e publicar conteúdo em nome de um usuário, exibir os posts desse usuário dentro do seu app, gerenciar respostas e excluir posts. O índice da documentação também lista perfis, menções, insights, webhooks, busca por palavra-chave e marcação de localização.

As chamadas vão para graph.threads.com ou graph.threads.net, com um access token. Os escopos são granulares, então peça só o que você usa:

Operação	Escopos necessários
Ler um perfil e seus posts	`threads_basic`
Publicar um post ou uma resposta	`threads_basic`, `threads_content_publish`
Ocultar, aprovar ou moderar respostas	`threads_basic`, `threads_content_publish`, `threads_manage_replies`
Apagar um post	`threads_basic`, `threads_delete`
Ler insights	`threads_basic`, `threads_manage_insights`
Marcar e buscar localizações	`threads_basic`, `threads_location_tagging`

Compare com o Instagram, onde publicar exige uma conta profissional vinculada a uma Página do Facebook mais o App Review, e você entende por que o Threads é onde eu digo para as pessoas testarem seu código de publicação primeiro.

API de publicação do Threads: o fluxo de publicação em duas etapas

Mesmo formato do Instagram. Crie um container de mídia, depois publique, como descrito no guia de posts.

# 1. create the container
curl -X POST "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads" \
  -d "media_type=TEXT" \
  -d "text=Shipping notes for the week" \
  -d "access_token=<TOKEN>"
# -> { "id": "17890000000000000" }

# 2. publish it
curl -X POST "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publish" \
  -d "creation_id=17890000000000000" \
  -d "access_token=<TOKEN>"

media_type aceita TEXT, IMAGE ou VIDEO, com image_url ou video_url para a mídia. Posts de texto são limitados a 500 caracteres, e emojis contam como seu número de bytes UTF-8, então um post cheio de emojis fica sem espaço antes do que a contagem de caracteres sugere.

A etapa que as pessoas pulam é a espera. O conselho da própria Meta: "wait on average 30 seconds before publishing a Threads media container to give our server enough time to fully process the upload". Publique cedo demais um vídeo e você recebe um erro, não um post. Inclua o atraso no código, ou faça polling do status do contêiner antes do passo 2.

Carrosséis, respostas e quem pode responder

Um carrossel é o mesmo fluxo com uma camada a mais: crie cada container filho com is_carousel_item=true, crie um container pai do tipo CAROUSEL listando os filhos, e então publique o pai. Mínimo de dois filhos, máximo de 20, e dá para misturar imagens e vídeos. Um carrossel conta como um único post no seu rate limit.

As respostas usam os mesmos endpoints de publicação com um reply_to_id, e têm orçamento próprio, separado do dos posts.

A moderação é onde a Threads API está genuinamente à frente da do Instagram. Segundo a documentação de gerenciamento de respostas:

reply_control é definido quando você cria o post e aceita everyone, accounts_you_follow, mentioned_only, parent_post_author_only ou followers_only.
enable_reply_approvals=true no container segura as respostas para aprovação em vez de publicá-las.
POST /<THREADS_REPLY_ID>/manage_reply oculta ou reexibe uma resposta de primeiro nível e tudo o que estiver aninhado nela.
POST /<THREADS_REPLY_ID>/manage_pending_reply aprova ou rejeita uma resposta que está na fila, e GET /<threads-media-id>/pending_replies lista todas elas.

Se você está construindo qualquer tipo de resposta automática, leia essa lista duas vezes. Poder segurar respostas para aprovação é o que torna uma conta automatizada sustentável.

Rate limits: os números que moldam sua fila

As três são janelas móveis de 24 horas, por perfil do Threads, segundo a visão geral da API:

Operação	Limite por 24 horas
Posts publicados	250
Respostas	1,000
Exclusões	100
Buscas por localização	500

Há também uma fórmula de volume de chamadas por cima: 4800 vezes o número de impressões, com um mínimo de 10 impressões. Um perfil novo em folha, sem alcance, fica então com um orçamento de chamadas pequeno, o que surpreende quem testa com uma conta vazia.

Colocando ao lado dos irmãos, verificados no mesmo dia: o Instagram permite 100 posts publicados via API a cada 24 horas, e as Páginas do Facebook usam 4800 chamadas vezes o número de usuários engajados. O Threads é o mais generoso dos três em volume de publicação. A tabela completa entre plataformas está na nossa referência de rate limits de APIs de redes sociais, e o panorama mais amplo está no guia de APIs de redes sociais 2026.

Insights: o que você consegue medir de verdade

Dois endpoints, ambos exigindo threads_manage_insights, segundo a documentação de insights.

Por post, GET /<threads-media-id>/insights retorna views, likes, replies, reposts, quotes e shares.

Por conta, GET /<threads-user-id>/threads_insights retorna views como série temporal, e likes, replies, reposts, quotes, clicks, followers_count e follower_demographics como totais. Repare que a métrica de conta replies conta só respostas de primeiro nível, então ela vai aparecer menor do que a soma das contagens de respostas por post.

Um limite rígido: o timestamp mais antigo que a API aceita é 1712991600, 13 de abril de 2024. Qualquer intervalo que comece antes disso é rejeitado, então um job de backfill precisa limitar sua data inicial.

Novidades da Threads API: o que está na documentação em setembro de 2026

A Threads API foi lançada em 2024 com publicação e leituras básicas. Lendo a documentação hoje, quatro coisas vão além daquela primeira versão: moderação de respostas com aprovações pendentes, busca por palavra-chave, webhooks e marcação de localização, com escopo próprio threads_location_tagging e um limite de 500 buscas por dia.

Para a maioria dos projetos, os webhooks são o que mais importa. Fazer polling de GET /<threads-media-id>/pending_replies em intervalos regulares queima seu orçamento de chamadas naquela fórmula de impressões; assinar os webhooks não.

Você precisa de uma integração com o Threads, ou de uma camada por cima dela

Sinceramente: se o Threads é a única rede que te interessa, faça a integração direta. É a integração mais barata desta categoria inteira. Sem review, dois endpoints para publicar, escopos granulares, documentação decente. Você vai estar publicando em uma tarde.

O argumento a favor de uma camada é o mesmo de sempre: você também quer Instagram, LinkedIn, X, TikTok e YouTube, e não quer seis armazenamentos de token, seis pipelines de mídia e três app reviews. O PlugKit publica no Threads, com as mesmas restrições que a Meta define: só texto até 500 caracteres, uma imagem ou vídeo, ou um carrossel de 2 a 20. O guia de publicação traz os detalhes plataforma por plataforma.

Para ver o que uma camada muda quando quem chama é um agente, e não um cron job, veja o guia de setup do Hermes Agent e o hub /social-media-api/. O PlugKit custa $49 por mês para 5 contas conectadas, e você cancela quando quiser.

Perguntas frequentes

O Threads tem uma API oficial?

Sim. A Meta lançou a Threads API em 2024 e hoje ela cobre publicação, leitura dos seus próprios posts e perfil, respostas e moderação, insights, webhooks, busca por palavra-chave e marcação de localização. Ela roda em graph.threads.com ou graph.threads.net com access tokens OAuth e escopos granulares.

Quantos posts posso publicar por dia pela Threads API?

250 posts publicados dentro de um período móvel de 24 horas, por perfil do Threads. As respostas têm um orçamento separado de 1.000 por 24 horas e as exclusões são limitadas a 100. Um carrossel conta como um post, não como um post por imagem.

A Threads API é gratuita?

A Meta não cobra pelas chamadas à Threads API. O custo está nos limites: os tetos de posts, respostas e exclusões acima, mais um orçamento de chamadas de 4800 vezes o seu número de impressões, com um mínimo de 10 impressões, ou seja, um perfil sem audiência recebe uma cota pequena.

Preciso de app review para publicar no Threads pela API?

Não para o seu próprio perfil. Publicar exige os escopos threads_basic e threads_content_publish, que você mesmo pode autorizar. O app review entra em cena quando seu app age em nome do perfil de outras pessoas, que é a mesma regra do resto da plataforma da Meta.

Dá para agendar posts no Threads pela API?

Do lado da Meta, não. A API publica quando você chama threads_publish, então o seu próprio agendador segura a fila e dispara no minuto certo, ou você usa um serviço que segura essa fila para você. Lembre da espera recomendada de 30 segundos entre criar o container e publicá-lo.

Antoine BlancoFundador da PlugKit. Gerencia as próprias contas de Instagram, YouTube e X pela API e pelo servidor MCP descritos aqui.

Um plug para cada plataforma que seu agente usa

$49 por mês para 5 contas conectadas, cancele quando quiser. Todos os recursos em todos os planos.

Pegue sua chave de API →