Threads Public Data API
Obtenga perfiles públicos de Threads, resuelva publicaciones conocidas o recopile publicaciones de perfiles seleccionados con campos normalizados de identidad, contenido, multimedia, interacción y marca de tiempo.
API de Threads disponibles
Use Profiles para los datos de una cuenta, Posts para una publicación pública conocida o User Posts para una colección acotada de perfiles seleccionados.

threads/posts
Publicaciones0.5 créditos por resultado

threads/profiles
Perfiles0.6 créditos por resultado

threads/user-posts
Publicaciones0.5 créditos por resultado

threads/post-replies
Comentarios0.3 créditos por resultado

threads/search
Búsqueda0.6 créditos por resultado

threads/search-users
Búsqueda0.6 créditos por resultado

threads/user-replies
Publicaciones0.5 créditos por resultado

threads/user-reposts
Publicaciones0.5 créditos por resultado
¿Qué datos de Threads se pueden obtener?
SocQ devuelve registros públicos normalizados de cuentas y publicaciones, con contexto de identidad, contenido, multimedia, interacción visible, origen y momento de recopilación.
Detalles de perfiles públicos
Obtenga ID de perfil, URL, nombres de usuario, nombres visibles, biografías, imágenes, sitios web vinculados, conteos visibles de la cuenta y momento de recopilación.
Contenido de publicaciones conocidas
Convierta la URL de una publicación pública en la identidad de la publicación, su texto, los datos del autor, la URL de origen y la multimedia disponible.
Interacción visible de las publicaciones
Conserve las fechas de publicación y de recopilación junto con los conteos disponibles de Me gusta, comentarios, reposts y veces compartido.
Publicaciones de perfiles seleccionados
Explore un conjunto acotado de publicaciones públicas de cada URL de perfil y mantenga el perfil enviado vinculado a los resultados.
SocQ vs Threads API
SocQ se centra en la recopilación compatible de datos públicos de Threads. Threads API de Meta está diseñada para flujos autorizados de publicación, respuestas, estadísticas y descubrimiento compatible.
| Funcionalidad | SocQ | Threads API |
|---|---|---|
| Uso principal | Recopilar perfiles públicos, publicaciones y las publicaciones recientes de un usuario | Crear integraciones autorizadas de publicación, respuestas, estadísticas y descubrimiento |
| OAuth del cliente | Clave de API de SocQ; sin OAuth de Threads del cliente | App de Meta, autorización de usuario de Threads y token de acceso |
| Entrada inicial | URL pública de un perfil o de una publicación de Threads | Contexto de cuenta autorizado, ID de Threads y parámetros de búsqueda compatibles |
| Publicar o administrar respuestas | No compatible | Compatible con los permisos de Threads requeridos |
| Formato de respuesta | Registros normalizados de SocQ | Objetos nativos de Threads Graph API |
Cómo funciona la API de Threads
Profiles, Posts y User Posts usan el mismo flujo de tarea asíncrona y resultados paginados.
1. Enviar URL públicas
Envíe URL de perfiles o de publicaciones a la API correspondiente y guarde el task_id devuelto.
2. Seguir la tarea
Consulte /v1/tasks/{task_id} hasta que el procesamiento termine.
3. Obtener los resultados
Lea data.results.items y use next_cursor mientras has_more sea true.
Autentíquese con su clave de API de SocQ y envíe la URL de un perfil público a User Posts. Profiles y Posts usan el mismo flujo de tarea.
curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso frecuentes de la API de Threads
Investigación de creadores y perfiles
Enriquezca URL de perfiles conocidos con identidad pública, biografía, sitio web, métricas visibles de la cuenta y momento de recopilación.
Análisis de publicaciones conocidas
Convierta URL de publicaciones seleccionadas en contenido, autor, multimedia, fecha de publicación, interacción visible y campos de origen.
Monitoreo del contenido de creadores
Recopile un conjunto acotado de publicaciones de perfiles seleccionados y compare el contenido entre recopilaciones repetidas.
Informes de interacción
Use los conteos visibles y collected_at para comparar instantáneas de publicaciones públicas sin tratarlas como métricas en tiempo real.
Límites y política de datos públicos
Los resultados de Threads son registros públicos de un momento determinado. Estas API no acceden a contenido privado ni publican, editan, eliminan o administran cuentas y publicaciones de Threads.
- Profiles acepta URL /@username de threads.com y threads.net. Se rechazan los nombres de usuario sueltos y las URL de publicaciones.
- Posts acepta URL /@username/post/{post_id}. No admite results_limit ni el descubrimiento de publicaciones de un perfil.
- User Posts acepta URL de perfil /@username. results_limit tiene un valor predeterminado de 100, admite de 1 a 2,000 y se aplica por separado a cada perfil.
- User Posts no indica si un resultado es una publicación original, una respuesta, una cita o un repost.
- Una publicación puede incluir comments_count, pero no se devuelven las respuestas individuales ni los árboles de respuestas.
- Los campos opcionales de identidad, contenido, multimedia, marca de tiempo e interacción pueden estar vacíos cuando el registro público no los expone.
Preguntas frecuentes sobre la API de Threads
¿Qué es la API de Threads?
La API de Threads es un conjunto de endpoints de SocQ para obtener datos de perfiles públicos, resolver publicaciones conocidas y recopilar un conjunto acotado de publicaciones de perfiles seleccionados.
¿Qué API de Threads debo usar?
Use Profiles para registros de cuentas /@username, Posts para enlaces exactos /@username/post/{post_id} y User Posts para una colección acotada a partir de cada URL de perfil /@username.
¿Cómo funciona el límite de resultados de User Posts?
results_limit tiene un valor predeterminado de 100, admite enteros de 1 a 2,000 y se aplica por separado a cada URL de perfil enviada.
¿Los resultados de User Posts identifican respuestas o reposts?
No. El resultado normalizado no expone ningún subtipo de publicación. Trate cada elemento como una publicación pública encontrada a partir del perfil enviado, sin deducir si es original, respuesta, cita o repost.
¿Las publicaciones y las métricas de interacción de Threads son completas o en tiempo real?
No. Los resultados reflejan los campos públicos disponibles en el momento de la recopilación, no incluyen árboles de respuestas completos y deben tratarse como instantáneas de un momento determinado, no como feeds en tiempo real.
¿Cuánto cuesta la recopilación de datos de Threads?
Cada perfil devuelto cuesta 0.6 créditos, mientras que cada publicación devuelta por Posts o User Posts cuesta 0.5 créditos. Los conjuntos de resultados vacíos no tienen cargo por resultado.
Combine datos de varias plataformas para obtener información de negocio más completa
Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.
Bluesky API
Obtenga perfiles públicos de Bluesky, resuelva URL de publicaciones conocidas o recopile una página de publicaciones de una cuenta con identidad, contenido, contenido multimedia, marcas de tiempo y campos visibles de interacción normalizados.
Snapchat API
Obtenga un Spotlight público conocido de Snapchat como un registro normalizado con los campos disponibles de creador, descripción, multimedia, audio, marca de tiempo, duración e interacción.
Twitch API
Convierta un nombre de usuario público conocido de Twitch en un perfil normalizado, recopile su inventario público de videos u obtenga un clip con su video descargable para investigación de creadores de contenido, enriquecimiento de catálogos, comparaciones y monitoreo mediante instantáneas.
Rednote API
Obtenga perfiles y notas públicos, busque notas o usuarios, recopile comentarios y respuestas anidadas, y capture una página de recomendaciones de inicio.
Kwai API
Obtenga perfiles públicos de Kwai, una página de publicaciones de una cuenta o una publicación conocida, con identidad, contenido, contenido multimedia, marcas de tiempo e interacción visible normalizados.
Truth Social API
Obtenga los datos de una cuenta pública, recopile una página de origen de publicaciones de una cuenta o convierta la URL de una publicación conocida en registros normalizados.