API · MCP
Dados públicos do Threads,dentro do seu agente e do seu produto.
Busca de posts, tendências de palavras-chave, rankings, contas e histórico de seguidores: conecte ao Claude, ChatGPT ou Cursor com MCP, ou ao seu serviço com REST. Cada resposta vem com números que você pode conferir.
Uma consulta
Throk MCP
Quais termos de marca esquentaram nos últimos 7 dias?
- 01
Buscar posts relacionados
- 02
Comparar o volume diário
- 03
Redigir conclusões verificáveis
Posts públicos do Threads em chinês tradicional e simplificado, cantonês, inglês, japonês e coreano. Tendências de palavras-chave de até 90 dias e histórico de seguidores de até 365. A partir de US$30/mês.
AGENTE EM AÇÃO
Como um agente usa esses dados?
Faça uma pergunta real e veja o agente chamar as ferramentas, ler os dados e dar uma recomendação baseada neles. Abaixo, uma conversa de exemplo.
mcp · throk
Dados de exemplo
Trocar de emprego (換工作) ainda rende post no Threads de Taiwan?
⚙ get_hot_posts⚙ get_keyword_trend⚙ search_posts
Ainda está esquentando. Os posts sobre trocar de emprego cresceram 3,1 vezes nos últimos 7 dias, e nenhum post estourado com mais de 50 mil curtidas dominou o assunto até agora:
6/07
6/09
6/11
6/13
Ângulo sugerido: esqueça o “pedi demissão” e escreva sobre o que pensa quem ficou. 38% das respostas com mais engajamento vêm de quem ainda não saiu e está em cima do muro. Essas pessoas procuram alguém que fale por elas.
COMO CONECTAR
MCP ou REST
MCP para agentes, REST para serviços.
01 · THROK MCP
Servidor MCP
Conecte o Claude, o Cursor ou qualquer outro cliente MCP com um comando.
Sobre o servidor MCP do Threads02 · REST API
API REST
Ou chame a API REST direto
PREÇOS DA API DO THREADS
A partir de US$30/mês. Escolha o plano pelo volume mensal de créditos.
Os quatro planos incluem todos os endpoints de dados e o MCP; a partir do Standard, também webhooks. O Throk MCP e a API REST usam os mesmos créditos de desenvolvedor.
O QUE ELE RESPONDE
O que o seu agente de IA consegue responder com a Throk?
Comece pela decisão que você precisa tomar e depois escolha os dados do Threads para ela. Nomes das ferramentas e limites de consulta ficam na referência técnica.
- 01
Encontre assuntos e demanda
Busque posts, conteúdos semanticamente parecidos e volume de palavras-chave.
- 02
Estude concorrentes e contas
Confira o conteúdo recente, os posts de maior sucesso e a variação de seguidores.
- 03
Pegue tendências e o momento certo
Confira rankings de posts em alta, rankings de crescimento e os melhores horários para postar.
Ver as 19 ferramentas e os limites de consulta+
LISTA COMPLETA DE FERRAMENTAS
19 ferramentas, uma chave
Busca por palavra-chave e semântica, rankings de posts em alta e virais, melhores respostas e crescimento de seguidores, mapas de calor de horários de pico, réguas de seguidores e curtidas, perfis de usuários, histórico de seguidores, dados ao vivo e previsões de viralização. Está tudo aí.
| Ferramenta | Retorna | Limite |
|---|---|---|
| search_posts | Busca de posts públicos por palavra-chave | 25 por chamada |
| get_inspiration | Ideias de posts selecionados com alto engajamento | 10 resultados |
| semantic_search_posts | Busca semântica nos posts dos últimos 30 dias | 10 resultados |
| get_hot_posts | Ranking de posts em alta | 50 resultados |
| get_keyword_trend | Volume diário de palavras-chave | 10 palavras-chave × 90 dias |
| get_post_like_growth | Ranking de posts virais | 50 resultados |
| get_cool_replies | Ranking de melhores respostas | 50 resultados |
| get_follower_growth | Ranking de crescimento de seguidores | 50 resultados |
| get_power_hours | Mapa de calor dos horários de pico | Últimos 28 dias |
| get_follower_ladder | Régua de seguidores | Percentil |
| get_like_ladder | Régua de curtidas | Últimas 24 horas |
| get_user | Perfil e posts recentes | 25 de cada |
| get_user_top_threads | Posts mais curtidos de um usuário | Até 720 dias |
| get_user_follower_history | Histórico de seguidores | Até 365 dias |
| get_user_interactions | As contas com quem mais interage | Até 100, 90 dias |
| forecast_posts | Previsão de viralização: visualizações em 48 horas e chance de atingir cada marco | 10 posts por chamada, de 1 a 12 h após a publicação |
| get_live_posts | Métricas e imagens de posts ao vivo | 10 posts por chamada |
| get_live_users | Seguidores e perfis ao vivo | 10 contas por chamada |
| get_balance | Créditos restantes | Grátis |
O que dá para construir
O que você pode construir
Cada ideia usa só ferramentas e endpoints que já existem.
Painel de menções da marca
Busque todo dia o volume dos termos da sua marca com get_keyword_trend e envie ao time, por webhook, os posts que passarem do limite.
Relatório semanal da concorrência
Chame get_user e o histórico de seguidores de forma agendada ou pelo n8n e transforme o resultado num relatório semanal.
Seleção de criadores
Use o ranking de seguidores por percentil para ver onde a conta está e confira com quem ela mais interage para entender o círculo dela.
Redator com IA
No Claude, consulte antes os posts em alta e as melhores respostas, e depois peça um rascunho baseado nesses dados.
Perguntas frequentes
- Os créditos da API são os mesmos da assinatura da Throk?
- Não. A plataforma para desenvolvedores tem planos e créditos de API próprios, totalmente separados dos planos web Free / Creator / Creator+, e os dois não se misturam. Você assina um plano de API no console de desenvolvedor.
- Qual a diferença entre a API da Throk e a Threads API oficial da Meta?
- A Threads API oficial da Meta serve para publicar posts e gerenciar a sua própria conta, e exige a revisão de apps da Meta. A API da Throk serve para consultar dados públicos do Threads: busca de posts, tendências de palavras-chave, rankings e o histórico de seguidores de qualquer conta pública. As duas têm funções diferentes e podem ser usadas juntas.
- Tem plano gratuito? Como funciona o preço?
- Os planos variam pelos créditos mensais, do API Lite (15.000 créditos/mês) ao Premium (6.000.000 créditos/mês); escolha na plataforma de desenvolvedores. Consultar saldo e histórico de uso, e os eventos de teste de webhook, não consomem créditos.
- Quando os créditos expiram?
- Os créditos valem por um mês a partir da compra, e o saldo não usado não passa para o mês seguinte. Se precisar de mais, faça upgrade ou uma recarga avulsa pela tarifa do seu plano (API Standard US$10, Plus US$5, Premium US$4 a cada 10.000 créditos). As recargas são zeradas quando o ciclo de cobrança atual termina.
- MCP ou REST? Quais clientes são compatíveis?
- Use MCP quando um agente de IA for fazer o trabalho: Claude, ChatGPT, Codex, Cursor e outros clientes se conectam com um comando. Use REST para chamar direto do seu próprio serviço. Todos os recursos estão disponíveis nos dois.
- Quais dados estão incluídos?
- Posts públicos do Threads: busca por palavra-chave, rankings de posts em alta, tendências de palavras-chave, perfis de contas e histórico de seguidores. Os posts são agrupados pelo idioma em que foram escritos, não pelo lugar onde o autor está. Cada chamada aceita um idioma pelo parâmetro language: zh (chinês, todos), zh-Hant (chinês tradicional), zh-Hans (chinês simplificado), yue (cantonês), en (inglês), ja (japonês) ou ko (coreano). O padrão é zh, então informe en, ja ou ko para receber posts em inglês, japonês ou coreano, e faça uma chamada por idioma para compará-los. Todos os endpoints de busca, tendências, rankings e percentis aceitam os 7 idiomas; as regras de webhook aceitam posts em chinês, japonês e coreano. Outros idiomas, incluindo o português, ainda não são cobertos.
- Como eu começo?
- Cadastre-se em developer.throk.ai, crie uma chave de API, escolha um plano e comece a fazer chamadas. No MCP, você pode dispensar a chave e entrar com a sua conta da Throk.
Deixe seu agente começar a ler o Threads.
Escolha um plano e crie uma chave na plataforma de desenvolvedores. Com o MCP, você também pode entrar direto com sua conta Throk.