threads/
search

Busque en Threads por palabra clave o hashtag y obtenga los posts destacados que muestra la app, unos 20 por búsqueda, cada uno con texto, autor, Me gusta, respuestas, reposts, contenido multimedia y hora de publicación.

Threads Search API

Palabra clave o hashtag
Posts destacados según Threads
Me gusta, respuestas y reposts
0.6 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 Search

La búsqueda de Threads muestra los posts que la app clasifica más arriba para una palabra clave o un hashtag, y cada uno llega con su texto, autor, hora de publicación, imágenes o videos adjuntos y los conteos de Me gusta, respuestas y reposts. Así se obtiene una lectura rápida de cómo se está hablando ahora mismo de un tema, un producto o un evento y de qué cuentas están marcando la conversación.

Funcionalidades de la Threads Search API

  • Una consulta, los posts destacadosPonga una palabra clave o un hashtag en query y reciba los posts destacados que Threads muestra para ella, unos 20, en la clasificación que usa la app.
  • Me gusta, respuestas y reposts en cada resultadometrics.likes_count, metrics.comments_count para las respuestas y metrics.shares_count para los reposts muestran qué resultados atraen más atención.
  • Las cuentas detrás de cada postauthor devuelve el nombre de usuario, el nombre visible, la url del perfil, el avatar e is_verified, para identificar a quienes lideran un tema junto con lo que dijeron.
  • Contenido multimedia y fechasmedia enumera las imágenes o videos adjuntos con sus dimensiones, y published_at fecha cada post para revisar qué tan reciente es.

Parámetros de la Threads Search API

ParámetrosObligatorioDescripción
queryObligatorioLa palabra clave o el hashtag que se busca, como basketball o el hashtag de una campaña. Una consulta por solicitud.

Cómo usar la Threads Search API

Envíe una consulta y lea los posts destacados cuando termine la tarea.

  1. Envíe {"query": "basketball"} por POST a /v1/threads/search y guarde el task_id devuelto.
  2. Consulte GET /v1/tasks/{task_id} hasta que indique succeeded.
  3. Lea los posts en results.items; si has_more es true, pida el resto con results.next_cursor.
curl -X POST "https://api.socq.ai/v1/threads/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"basketball"}'

# 0.6 credits per post returned; a search with no matches is free.

Casos de uso de la Threads Search API

  • Tomar el pulso de un tema: Busque un producto, un evento o un asunto y lea el texto de los posts destacados para ver qué enfoques y opiniones dominan la conversación.
  • Identificar las voces que mueven una conversación: Ordene a los autores de los resultados por los Me gusta y reposts que obtuvieron sus posts, y anote cuáles están verificados, para armar una lista de contacto o de seguimiento.
  • Monitorear un nombre de marca o un hashtag: Ejecute la misma consulta de forma periódica y guarde los id de posts nuevos con su published_at para tener un registro continuo de menciones recientes.

Consejos de expertos para la Threads Search API

  • Divida un tema amplio en varias consultas más específicas, como nombres de productos, variantes de escritura y hashtags relacionados, ya que cada búsqueda devuelve unos 20 posts destacados.
  • Combine por id los resultados de consultas que se superponen, para que un post que aparece en dos búsquedas se cuente una sola vez.
  • Interprete metrics.comments_count como la cantidad de respuestas y metrics.shares_count como la cantidad de reposts al nombrar las columnas de sus reportes.
  • Pase la url de cualquier resultado a Threads Post Replies API cuando necesite la conversación que hay debajo.

Además de la Threads Search 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 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 User Search API — Encuentra cuentas de Threads por nombre o nombre de usuario, con nombres de usuario, nombres visibles, URL de perfil, avatares y estado de verificació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.

Explorar otras plataformas

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

Threads Search API — FAQ

Threads Search API es una interfaz programática para buscar posts públicos de Threads por palabra clave o hashtag. Devuelve los posts destacados de la consulta con su texto, autor, Me gusta, respuestas, reposts, contenido multimedia y hora de publicación.

Ponga el hashtag en query igual que una palabra clave y recibirá los posts que Threads clasifica para esa etiqueta.

Unos 20, en el orden en que Threads clasifica sus resultados destacados para la consulta. Ordénelos usted mismo por published_at cuando necesite primero los más recientes.

Cada post devuelto cuesta 0.6 créditos, así que una búsqueda completa de unos 20 posts ronda los 12 créditos.