API · MCP
Datos públicos de Threads,dentro de tu agente y tu producto.
Búsqueda de publicaciones, tendencias de palabras clave, rankings, cuentas e historial de seguidores: conéctalos a Claude, ChatGPT o Cursor con MCP, o a tu servicio con REST. Cada respuesta trae cifras que puedes comprobar.
Una consulta
Throk MCP
¿Qué términos de marca tomaron fuerza en los últimos 7 días?
- 01
Buscar publicaciones relacionadas
- 02
Comparar el volumen diario
- 03
Redactar conclusiones verificables
Publicaciones públicas de Threads en chino tradicional y simplificado, cantonés, inglés, japonés y coreano. Tendencias de palabras clave de hasta 90 días e historial de seguidores de hasta 365. Desde US$30/mes.
EL AGENTE EN ACCIÓN
¿Cómo usa un agente estos datos?
Haz una pregunta real y mira cómo el agente llama a las herramientas, lee los datos y da un consejo basado en ellos. Abajo verás una conversación de ejemplo.
mcp · throk
Datos de ejemplo
¿Todavía vale la pena publicar sobre cambiar de trabajo (換工作) en el Threads de Taiwán?
⚙ get_hot_posts⚙ get_keyword_trend⚙ search_posts
Sigue en alza. Las publicaciones sobre cambiar de trabajo crecieron 3.1 veces en los últimos 7 días, y todavía no aparece ninguna publicación de más de 50,000 me gusta que acapare el tema:
6/07
6/09
6/11
6/13
Ángulo sugerido: olvídate del “renuncié a mi trabajo” y escribe sobre lo que piensan quienes se quedaron. El 38% de las respuestas con más interacción vienen de personas que no han renunciado y siguen con la duda. Buscan a alguien que hable por ellas.
CÓMO CONECTARTE
MCP o REST
MCP para agentes, REST para servicios.
01 · THROK MCP
Servidor MCP
Conecta Claude, Cursor o cualquier otro cliente MCP con un solo comando.
Sobre el servidor MCP de Threads02 · REST API
API REST
O llama directamente a la API REST
PRECIOS DE LA API DE THREADS
Desde US$30/mes. Elige un plan según los créditos que necesitas.
Los cuatro planes incluyen todos los endpoints de datos y MCP; desde Standard se suman los webhooks. Throk MCP y la API REST usan los mismos créditos de desarrollador.
QUÉ PUEDE RESPONDER
¿Qué puede responder tu agente de IA con Throk?
Parte de la decisión que necesitas tomar y elige los datos de Threads que la respaldan. Los nombres de las herramientas y los límites de consulta están en la referencia técnica.
- 01
Encuentra temas y demanda
Busca publicaciones, contenido semánticamente similar y volumen de palabras clave.
- 02
Estudia competidores y cuentas
Revisa el contenido reciente, las publicaciones más exitosas y los cambios en seguidores.
- 03
Detecta tendencias y el mejor momento
Consulta rankings de tendencias, rankings de crecimiento y los mejores horarios para publicar.
Ver las 19 herramientas y los límites de consulta+
LISTA COMPLETA DE HERRAMIENTAS
19 herramientas, una clave
Búsqueda por palabra clave y semántica, rankings de tendencias y virales, mejores respuestas y crecimiento de seguidores, mapas de calor de mejores horarios, escaleras de seguidores y de me gusta, perfiles de usuario, historial de seguidores, datos en vivo y pronósticos virales. Está todo ahí.
| Herramienta | Devuelve | Límite |
|---|---|---|
| search_posts | Búsqueda por palabra clave en publicaciones públicas | 25 por llamada |
| get_inspiration | Ideas de publicaciones seleccionadas con mucha interacción | 10 resultados |
| semantic_search_posts | Búsqueda semántica en las publicaciones de los últimos 30 días | 10 resultados |
| get_hot_posts | Ranking de publicaciones en tendencia | 50 resultados |
| get_keyword_trend | Volumen diario de palabras clave | 10 palabras clave × 90 días |
| get_post_like_growth | Ranking de hilos virales | 50 resultados |
| get_cool_replies | Ranking de mejores respuestas | 50 resultados |
| get_follower_growth | Ranking de crecimiento de seguidores | 50 resultados |
| get_power_hours | Mapa de calor de mejores horarios | Últimos 28 días |
| get_follower_ladder | Escalera de seguidores | Percentil |
| get_like_ladder | Escalera de me gusta | Últimas 24 horas |
| get_user | Perfil y publicaciones recientes | 25 de cada uno |
| get_user_top_threads | Las publicaciones con más me gusta de un usuario | Hasta 720 días |
| get_user_follower_history | Historial de seguidores | Hasta 365 días |
| get_user_interactions | Las cuentas con las que más interactúa | Hasta 100, 90 días |
| forecast_posts | Pronóstico viral: vistas a 48 horas y probabilidad de alcanzar cada hito | 10 publicaciones por llamada, 1–12 h después de publicar |
| get_live_posts | Estadísticas e imágenes de publicaciones en vivo | 10 publicaciones por llamada |
| get_live_users | Seguidores y perfiles en vivo | 10 cuentas por llamada |
| get_balance | Créditos restantes | Gratis |
Qué puedes construir
Lo que puedes construir
Cada idea usa solo herramientas y endpoints que ya existen.
Panel de menciones de marca
Trae a diario el volumen de tus términos de marca con get_keyword_trend y envía a tu equipo, por webhook, las publicaciones que superen el umbral.
Informe semanal de la competencia
Llama a get_user y al historial de seguidores de forma programada o desde n8n, y conviértelo en un informe semanal.
Selección de creadores
Usa el escalafón de seguidores para ver dónde está una cuenta y revisa con quién interactúa más para conocer su círculo.
Redactor con IA
En Claude, consulta primero las publicaciones en tendencia y las mejores respuestas, y luego pídele un borrador basado en esos datos.
Preguntas frecuentes
- ¿Los créditos de la API son los mismos que los de la suscripción a Throk?
- No. La plataforma para desarrolladores tiene sus propios planes y créditos de API, totalmente separados de los planes web Free / Creator / Creator+, y no se pueden combinar. Te suscribes a un plan de API en la consola para desarrolladores.
- ¿En qué se diferencia la API de Throk de la Threads API oficial de Meta?
- La Threads API oficial de Meta sirve para publicar y gestionar tu propia cuenta, y requiere la revisión de apps de Meta. La API de Throk sirve para consultar datos públicos de Threads: búsqueda de publicaciones, tendencias de palabras clave, rankings y el historial de seguidores de cualquier cuenta pública. Cumplen funciones distintas y se pueden usar juntas.
- ¿Hay plan gratuito? ¿Cuánto cuesta?
- Los planes se diferencian por créditos mensuales, desde API Lite (15.000 créditos/mes) hasta Premium (6.000.000 créditos/mes); elige uno en la plataforma de desarrolladores. Consultar el saldo y el historial de uso, y los eventos de prueba de webhook, no consumen créditos.
- ¿Cuándo vencen los créditos?
- Los créditos valen por un mes desde la compra, y los que no uses no se acumulan. Si necesitas más, sube de plan o compra una recarga única a la tarifa de tu plan (API Standard US$10, Plus US$5, Premium US$4 por cada 10,000 créditos). Las recargas se reinician al terminar el ciclo de facturación en curso.
- ¿MCP o REST? ¿Qué clientes son compatibles?
- Usa MCP cuando el trabajo lo vaya a hacer un agente de IA: Claude, ChatGPT, Codex, Cursor y otros clientes se conectan con un solo comando. Usa REST para hacer llamadas directamente desde tu propio servicio. Todas las funciones están disponibles en ambos.
- ¿Qué datos cubre?
- Publicaciones públicas de Threads: búsqueda por palabra clave, rankings de tendencias, tendencias de palabras clave, perfiles de cuentas e historial de seguidores. Las publicaciones se agrupan por el idioma en que están escritas, no por dónde vive el autor. Cada llamada acepta un idioma con el parámetro language: zh (chino, todo), zh-Hant (chino tradicional), zh-Hans (chino simplificado), yue (cantonés), en (inglés), ja (japonés) o ko (coreano). El valor predeterminado es zh, así que indica en, ja o ko para obtener publicaciones en inglés, japonés o coreano, y haz una llamada por idioma para compararlos. Todos los endpoints de búsqueda, tendencias, rankings y escalafones admiten los 7 idiomas; las reglas de webhook admiten publicaciones en chino, japonés y coreano. Otros idiomas, incluido el español, todavía no están cubiertos.
- ¿Cómo empiezo?
- Regístrate en developer.throk.ai, crea una clave de API, elige un plan y empieza a hacer llamadas. Con MCP puedes saltarte la clave e iniciar sesión con tu cuenta de Throk.
Deja que tu agente empiece a leer Threads.
Elige un plan y crea una clave en la plataforma de desarrolladores. Con MCP también puedes iniciar sesión directamente con tu cuenta de Throk.