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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | La 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.
- Envíe {"query": "basketball"} por POST a /v1/threads/search y guarde el task_id devuelto.
- Consulte GET /v1/tasks/{task_id} hasta que indique succeeded.
- 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.
APIs relacionadas
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.