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 threadsbasic and threadscontentpublish 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 threadspublish, 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·6 min de leitura

Sim, o Threads tem uma API oficial, e é a mais amigável que a Meta oferece. Você publica em duas chamadas, pode ler seus posts, respostas e insights, e para o seu próprio perfil não há app review para passar. O teto é de 250 posts publicados e 1.000 respostas por 24 horas. Tudo 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 apagar 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 contêiner 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 mídia. Posts de texto têm limite de 500 caracteres, e emojis contam como seu número de bytes UTF-8, então um post cheio de emoji 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 contêiner filho com is_carousel_item=true, crie um contêiner pai do tipo CAROUSEL listando os filhos, depois publique o pai. Mínimo de dois filhos, máximo de 20, e imagens e vídeos podem ser misturados. 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 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 que está aninhado abaixo dela.
POST /<THREADS_REPLY_ID>/manage_pending_reply aprova ou rejeita uma que está esperando 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 lado a lado com os irmãos, verificado no mesmo dia: o Instagram permite 100 posts publicados via API por 24 horas, e Páginas do Facebook usa 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, conforme 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, já likes, replies, reposts, quotes, clicks, followers_count e follower_demographics como totais. Vale notar que a métrica de conta replies considera apenas respostas de primeiro nível, então ela vai ficar menor que a soma das contagens de respostas de cada 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 uma rotina 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 mais 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 seu próprio escopo threads_location_tagging e um teto de 500 buscas por dia.

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

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. A 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 tem o detalhe plataforma por plataforma.

Para saber o que muda com uma camada quando quem chama é um agente, e não um cron job, veja o guia de configuração do Hermes Agent e o hub /social-media-api/. O PlugKit custa US$ 29 por mês para 5 contas conectadas, cancele 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 do seu perfil, respostas e moderação, insights, webhooks, busca por palavra-chave e marcação de localização. Ela roda sobre graph.threads.com ou graph.threads.net com tokens de acesso 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. A revisão de app entra em cena quando seu app age em nome de perfis de outras pessoas, que é a mesma regra do resto da plataforma da Meta.

Dá para agendar posts no Threads pela API?

Não do lado da Meta. A API publica quando você chama threads_publish, ou seja, seu próprio agendador guarda a fila e dispara no minuto certo, ou você usa um serviço que faz isso por você. Lembre-se da espera recomendada de 30 segundos entre criar o contêiner 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

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

Pegue sua chave de API →