Saltar al contenido principal
Lee datos públicos de Threads como JSON mediante la API de tareas asíncronas. Envía taskType SOCIAL con platform threads y elige qué leer con action. Cada solicitud completada cuesta 0.5 créditos.

Solicitud

Envía la tarea y luego consulta GET /v1/async/task/{id} o recibe su webhook. Consulta Tareas asíncronas.

Acciones

username acepta un nombre de usuario o la URL de un perfil. postUrl acepta la URL de una publicación, como https://www.threads.com/@natgeo/post/Dfzi22JJSYp.

Parámetros

  • query: Obligatorio para search.
  • limit: Opcional. search y profile aceptan de 1 a 50, con 10 por defecto. replies acepta de 1 a 500, con 50 por defecto.

Ejemplo de respuesta

Campos del resultado

  • Cada respuesta repite platform y action. Las listas incluyen returnedCount.
  • Una publicación tiene id, code, url, text, author, authorVerified, publishedAt, mediaType (text, image, video o carousel), images, videoUrl, likeCount, replyCount, repostCount, quoteCount, shareCount e isReply. Una respuesta añade replyTo, el nombre de usuario al que responde.
  • search devuelve posts en el orden en que Threads los muestra, hasta unos 50.
  • profile devuelve id, username, displayName, biography, bioLinks, avatarUrl, profileUrl, isVerified, isPrivate, followerCount, threadCount y recentPosts, las 4 a 13 publicaciones más recientes que muestra la página del perfil.
  • post devuelve post. replies devuelve replies, unas 10 por publicación. availableCount es el número de respuestas de la publicación, y partial: true marca una lista más corta que ese número, como cuando el autor ocultó respuestas.
  • Un perfil o una publicación que no existe o no es pública termina la tarea con PAGE_UNAVAILABLE. Solo se cobran las solicitudes completadas.

Relacionado