Los primeros endpoints de Threads de SocQ leen perfiles públicos, publicaciones individuales y las publicaciones de un usuario. El 2026-11-17 se lanzaron cinco más. Dos de ellos son de búsqueda: encontrar publicaciones por palabra clave o hashtag y encontrar cuentas por nombre. Los otros tres leen conversaciones y difusión: las respuestas bajo una publicación, las respuestas que una cuenta deja en otras publicaciones y las publicaciones que republica.
Esta guía explica qué devuelve cada nuevo endpoint, la solicitud, el precio y cuándo usarlo. Para ver cómo se comparan con la API de Threads de Meta y con otros proveedores, consulte alternativas a la API de Threads.
Respuesta rápida: envíe una
queryaPOST /v1/threads/searcho/search-users, o URLs de Threads enurlsa/post-replies,/user-replieso/user-reposts, conAuthorization: Bearer $SOCQ_API_KEY. ConsulteGET /v1/tasks/{task_id}hasta questatusseasucceededy leadata.results.items. Los precios van de 0.3 a 0.6 créditos por resultado ($0.0015 a $0.003, a $0.005 por crédito), sin tarifa base.
Los cinco nuevos endpoints de Threads
| Endpoint | Qué devuelve | Entrada | Precio |
|---|---|---|---|
| Search | Las publicaciones principales para una palabra clave o un hashtag, unas 20, con texto, autor, me gusta, respuestas, republicaciones, multimedia y fecha | query | 0.6 créditos ($0.003) por publicación |
| User Search | Cuentas que coinciden con un nombre o nombre de usuario, normalmente hasta 10, con nombre visible, avatar y verificación | query | 0.6 créditos ($0.003) por cuenta |
| Post Replies | Respuestas bajo una publicación, unas 20 por publicación, con autor, me gusta, respuestas, multimedia y fecha | URLs de publicaciones | 0.3 créditos ($0.0015) por respuesta |
| User Replies | Las respuestas públicas más recientes de una cuenta, hasta unas 25, con interacción y multimedia | URLs de perfiles | 0.5 créditos ($0.0025) por respuesta |
| User Reposts | Publicaciones que una cuenta republicó recientemente, hasta unas 25, cada una con su autor original | URLs de perfiles | 0.5 créditos ($0.0025) por publicación |
Buscar en Threads
Threads Search: publicaciones por palabra clave o hashtag
La Threads Search API busca en Threads igual que la aplicación y devuelve las publicaciones principales para una palabra clave o un hashtag. Cada publicación incluye su texto, autor, me gusta, respuestas, republicaciones, multimedia y fecha de publicación. Es la forma más rápida de ver cómo se habla de un tema, un producto o un evento en Threads y de encontrar las cuentas que impulsan esa conversación.
curl -X POST "https://api.socq.ai/v1/threads/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "basketball"
}'
Cada búsqueda devuelve las publicaciones principales que Threads muestra para la consulta, unas 20. La interacción está en metrics: likes_count, comments_count y shares_count. Consulte la documentación de Search.
Threads User Search: cuentas por nombre
La Threads User Search API encuentra cuentas por nombre o nombre de usuario. Cada coincidencia devuelve el nombre de usuario, el nombre visible, la URL del perfil, el avatar y el estado de verificación. Úsela para confirmar el identificador correcto antes de obtener publicaciones o respuestas, o para convertir una lista de nombres en perfiles de Threads en una investigación de influencers.
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "shams"
}'
Cada búsqueda devuelve las cuentas que sugiere Threads, normalmente hasta 10. Consulte la documentación de User Search.
Leer conversaciones y republicaciones
Threads Post Replies: la conversación bajo una publicación
La Threads Post Replies API lee la conversación bajo una publicación. Cada respuesta incluye su texto, autor, número de me gusta y de respuestas, multimedia adjunta y fecha, además del post_id de la publicación a la que responde. Úsela para medir la reacción a un anuncio, recopilar comentarios de clientes en las publicaciones de una marca o encontrar a las personas más implicadas de la audiencia de un creador.
curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]
}'
Use URLs de publicaciones con el formato /@{username}/post/{code}. Cada publicación devuelve las respuestas que Threads muestra bajo ella, unas 20. Consulte la documentación de Post Replies.
Threads User Replies: cómo habla una cuenta con los demás
La Threads User Replies API devuelve las respuestas públicas más recientes de una cuenta con texto, me gusta, respuestas, multimedia, fecha y un enlace a cada respuesta. Las respuestas muestran el tono y el conocimiento de forma más directa que las publicaciones cuidadas, lo que las hace útiles para evaluar creadores, seguir a un portavoz o estudiar cómo gestiona una marca las conversaciones con sus clientes.
curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@reuters"]
}'
Use URLs de perfil como https://www.threads.com/@username. Cada perfil devuelve hasta unas 25 respuestas. Consulte la documentación de User Replies.
Threads User Reposts: a quién difunde una cuenta
La Threads User Reposts API devuelve las publicaciones que una cuenta decidió republicar. Cada fila es la publicación original con su autor, texto, interacción y multimedia. El historial de republicaciones es una señal directa de afinidad: muestra las voces en las que confía un creador, los socios que promociona una marca y el contenido que circula por una comunidad.
curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": ["https://www.threads.com/@shams"]
}'
Cada perfil devuelve hasta unas 25 republicaciones recientes; author es el autor original, no la cuenta que republicó. Consulte la documentación de User Reposts.
Un flujo de investigación sencillo
- Ejecute Search con el nombre de un producto o un hashtag para encontrar las publicaciones con más interacción.
- Pase las URLs de las publicaciones más destacadas a Post Replies para leer las reacciones.
- Use User Search para convertir los nombres que aparezcan en identificadores y, después, User Replies y User Reposts en esos perfiles para ver cómo hablan y a quién difunden.
- Para las publicaciones propias de una cuenta o los datos de su perfil, use los endpoints anteriores User Posts y Profiles.
Autenticación y flujo de tareas asíncronas
Cada solicitud incluye su clave de API y un tipo de contenido JSON:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada envío inicia una tarea en segundo plano:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La respuesta del envío devuelve data.task_id y data.status. Consulte la tarea con la misma clave:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Mientras la tarea está en queued, running o failed, la respuesta contiene solo los metadatos de la tarea; en failed, lea error_message. Cuando está en succeeded, la misma respuesta incluye la primera página de registros normalizados en data.results.items. limit es 50 por defecto y admite hasta 500. Si has_more es true, pase results.next_cursor como cursor para leer la página siguiente. fields acepta hasta 50 campos o rutas con puntos separados por comas.
Un tiempo de espera agotado en el cliente no cancela la tarea, así que reanude con el mismo task_id en lugar de volver a enviarla y pagar por un duplicado. También puede añadir callback_url al cuerpo del envío para recibir un único POST con un resumen de la tarea cuando esta termine.
Cuánto cuesta un trabajo típico
- Una búsqueda por palabra clave que devuelve 20 publicaciones: 20 × 0.6 = 12 créditos, $0.06.
- Respuestas bajo 10 publicaciones, unas 20 cada una: 200 × 0.3 = 60 créditos, $0.30.
- Respuestas y republicaciones de 10 cuentas, unas 25 cada una: 500 × 0.5 = 250 créditos, $1.25.
Preguntas frecuentes
¿Puedo pasar de los primeros 20 resultados de búsqueda?
Search devuelve las publicaciones principales que Threads muestra para la consulta, unas 20 por búsqueda. Para ampliar la cobertura, ejecute palabras clave o hashtags relacionados como búsquedas independientes.
¿Necesito iniciar sesión en Threads o Instagram?
No. Una solicitud contiene solo su clave de API de SocQ y una consulta o URLs públicas de Threads; no incluye credenciales de ninguna cuenta de Threads.
¿User Reposts muestra quién republicó?
La solicita para un solo perfil, así que todas las filas las republicó ese perfil. El author de cada fila es el autor original.
¿Puedo enviar varios perfiles o publicaciones a la vez?
Sí. Post Replies, User Replies y User Reposts aceptan una lista en urls, y las cantidades de resultados se aplican por URL.
¿Dónde puedo ver todos los endpoints y precios de Threads?
En la página de la plataforma Threads y en la página de precios.
THREADS API
Probar el flujo de trabajo con una URL pública de Threads
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de Threads