Threads User Posts
Los posts de un usuario de Threads son publicaciones públicas descubiertas en páginas de perfil seleccionadas, con el texto del post, la identidad del autor, referencias a archivos multimedia, horas de publicación y conteos visibles de interacción. Estos registros y sus marcas de tiempo de recopilación sirven para archivar el contenido de las cuentas, investigar formatos y comparar la interacción pública.
Funcionalidades de la Threads User Posts API
- Descubrimiento acotado por perfilAcepta una o más URL públicas de perfiles de Threads y aplica results_limit por separado a cada perfil, con un valor predeterminado de 100 y un rango admitido de 1 a 2,000.
- Registros normalizados de post, autor y archivos multimediaDevuelve los identificadores del post, las URL de origen, el texto, la identidad del autor disponible y las referencias públicas a archivos multimedia con una estructura de resultados coherente.
- Contexto de interacción y de descubrimientoMantiene los conteos visibles de Me gusta, comentarios, reposts y compartidos junto con la hora de publicación, collected_at y el contexto del perfil enviado cuando el registro de origen lo proporciona.
Parámetros de la Threads User Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de URL públicas de perfiles de Threads en threads.com o threads.net. Cada ruta debe usar /@username; se rechazan los nombres de usuario sueltos, las URL de posts y otras rutas que no corresponden. |
results_limit | Opcional | Máximo de posts que se solicitan para cada URL de perfil; el valor predeterminado es 100 y se aceptan enteros de 1 a 2,000. |
Cómo usar la Threads User Posts API
Envíe URL de perfiles públicos de Threads con un límite de resultados por perfil, siga la tarea asíncrona y lea los posts normalizados con paginación por cursor.
- Prepare una o más URL públicas de perfiles de Threads con la ruta /@username en threads.com o threads.net.
- Envíe por POST urls y un results_limit opcional a /v1/threads/user-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/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 de la Threads User Posts API
- Conjuntos de datos de posts de perfiles seleccionados: Conserve los ID de los posts, las URL de origen, el texto, los campos del autor, las referencias a archivos multimedia, las marcas de tiempo y el contexto del perfil enviado para un conjunto definido de perfiles públicos.
- Investigación de contenido y formatos: Use el texto de los posts, las referencias públicas a archivos multimedia, la atribución al autor y las horas de publicación para examinar los temas recurrentes y los formatos de contenido de perfiles seleccionados.
- Comparación de la interacción pública: Compare los conteos visibles de Me gusta, comentarios, reposts y compartidos entre recopilaciones de perfiles, usando collected_at para fijar el momento de cada observación.
Consejos de expertos para la Threads User Posts API
- Valide que cada entrada sea una URL de perfil /@username de threads.com o threads.net antes del envío, para que los nombres de usuario sueltos, los enlaces de posts y otras rutas que no corresponden no hagan fallar la solicitud.
- Planifique la profundidad solicitada y la estimación de créditos previa a la solicitud como la cantidad de urls multiplicada por results_limit, porque el límite se aplica por separado a cada perfil.
- Almacene discovery_input, input_url y collected_at con cada resultado para que los registros posteriores conserven el perfil enviado y la hora de observación.
- Trate el texto, los campos del autor, los archivos multimedia, created_at y las métricas individuales como opcionales, y no deduzca si un registro es un post original, una respuesta, una cita o un repost, porque no se expone ningún subtipo.
APIs relacionadas
Además de la Threads User Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Threads.
- Threads Posts API — Recolecta desde URLs de publicaciones de Threads compatibles el texto de publicaciones públicas, el contexto del autor, el contenido multimedia, las marcas de tiempo y la interacción visible.
- 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 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.