Threads Posts
Los posts de Threads son publicaciones públicas basadas en texto, con identidad del autor, referencias a archivos multimedia, hora de publicación y conteos visibles de Me gusta, comentarios, reposts y compartidos. Estos registros sirven para investigar posts seleccionados, revisar fuentes, comparar contenido y analizar la interacción en momentos concretos.
Funcionalidades de la Threads Posts API
- Resolución directa de URL de postsResuelve URL públicas de threads.com o threads.net con la forma /@username/post/{post_id} en registros de los posts exactos enviados, y no en el feed de un perfil.
- Contenido del post y atribución al autorDevuelve los identificadores del post, las URL de origen, el texto y los ID, nombres de usuario, nombres visibles y URL de perfil de los autores que estén disponibles, para obtener registros rastreables.
- Archivos multimedia e instantánea de la interacción visibleMantiene juntas, para cada post, las referencias normalizadas a archivos multimedia, las horas de publicación y de recopilación, y los conteos visibles de Me gusta, comentarios, reposts y compartidos.
Parámetros de la Threads Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL públicas de posts de Threads en threads.com o threads.net, con la ruta /@username/post/{post_id}. |
Cómo usar la Threads Posts API
Envíe los posts públicos de Threads que ya conoce, siga la tarea asíncrona y lea los resultados normalizados con paginación por cursor.
- Prepare una o más URL públicas de posts de Threads con la ruta /@username/post/{post_id} en threads.com o threads.net.
- Envíe los enlaces como urls a /v1/threads/posts y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un fallo.
- Lea data.results.items y solicite después el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/threads/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Threads Posts API
- Enriquecer una lista de posts seleccionados: Convierta URL de posts conocidas en registros con ID, texto, campos del autor, archivos multimedia, marcas de tiempo y enlaces de origen para un conjunto de datos definido.
- Revisar el contenido público y su atribución: Use el texto, las referencias a archivos multimedia, la identidad del autor y la URL original para examinar publicaciones seleccionadas conservando su origen público.
- Comparar instantáneas de interacción: Combine likes_count, comments_count, reposts_count y shares_count con collected_at para comparar observaciones capturadas en momentos distintos.
Consejos de expertos para la Threads Posts API
- Valide cada URL con la ruta /@username/post/{post_id} antes del envío, para que las páginas de perfil y otras rutas de Threads que no corresponden no hagan fallar la solicitud.
- Deduplique los enlaces enviados por la ruta del post antes de armar el lote, para que los nombres de host alternativos compatibles no generen trabajo repetido para el mismo post.
- Use este endpoint solo con URL de posts conocidas; omita results_limit, porque no descubre el feed de un perfil ni expande un post en sus respuestas.
- Trate el texto, los campos del autor, los archivos multimedia, la hora de publicación y las métricas individuales como opcionales, para que un post público expuesto parcialmente no interrumpa el procesamiento de resultados.
- Almacene collected_at junto con los campos de interacción visible para conservar el momento en que se observó cada instantánea.
APIs relacionadas
Además de la Threads Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Threads.
- Threads Profiles API — Recolecta desde URLs de perfiles de Threads compatibles la identidad del perfil público, las biografías, las imágenes, los sitios web, los conteos visibles de la cuenta y el contexto de recolección.
- Threads User Posts API — Descubre publicaciones públicas desde URLs de perfiles de Threads con un límite por perfil, y devuelve contenido normalizado, autores, contenido multimedia, marcas de tiempo, interacción visible y contexto de origen.
- Threads Post Replies API — Recolecta las respuestas bajo posts de Threads a partir de sus URL, con texto, autores, conteos de Me gusta y respuestas, contenido multimedia y el ID del post respondido.
- Threads Search API — Busca en Threads por palabra clave o hashtag los posts destacados, con texto, autores, Me gusta, respuestas, reposts, contenido multimedia y hora de publicación.
- Threads User Replies API — Recolecta las últimas respuestas públicas que publicó una cuenta a partir de URL de perfiles de Threads, con texto, interacción, contenido multimedia y enlaces.
- Threads User Reposts API — Recolecta los posts que una cuenta reposteó hace poco a partir de URL de perfiles de Threads, cada uno como el post original con su autor, texto, interacción y contenido multimedia.