threads/
user-posts

Descubra posts públicos de Threads a partir de una o más URL de perfiles compatibles, con el texto, el contexto del autor, los archivos multimedia, las marcas de tiempo y la interacción visible en registros normalizados.

Threads User Posts API

Entrada por URL de perfil
Límite de resultados por perfil
Posts públicos normalizados
0.5 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioLista 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_limitOpcionalMá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.

  1. Prepare una o más URL públicas de perfiles de Threads con la ruta /@username en threads.com o threads.net.
  2. Envíe por POST urls y un results_limit opcional a /v1/threads/user-posts y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un fallo.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Threads con datos públicos de otras plataformas sociales compatibles.

Threads User Posts API — FAQ

Threads User Posts API descubre registros de posts públicos a partir de una o más URL de perfiles de Threads compatibles. Devuelve el texto normalizado de los posts, el contexto del autor, los archivos multimedia, las marcas de tiempo, la interacción visible y el contexto del perfil enviado.

Envíe una URL HTTP o HTTPS en threads.com, www.threads.com, threads.net o www.threads.net cuya ruta siga la forma /@username. Se rechazan los nombres de usuario sueltos, las URL de posts y otras formas de ruta.

Los registros pueden incluir el ID del post, la URL, el texto, la identidad pública del autor, las referencias a archivos multimedia, los conteos visibles de Me gusta, comentarios, reposts y compartidos, created_at, collected_at y el contexto adicional de descubrimiento o de entrada en extra. Los valores opcionales de la fuente pueden ser nulos o estar vacíos.

results_limit tiene un valor predeterminado de 100 y acepta enteros de 1 a 2,000. Se aplica a cada URL de perfil, así que dos URL con results_limit 50 solicitan hasta 100 posts.

La respuesta normalizada no expone ningún subtipo de post. Trate cada elemento como un post público descubierto a partir de la URL de perfil enviada, sin deducir si es un post original, una respuesta, una cita o un repost.

Cada registro de post devuelto cuesta 0.5 créditos de SocQ. La estimación usa urls multiplicado por results_limit, y un conjunto de resultados vacío no tiene cargo por resultados.