Threads User Search
La búsqueda de usuarios de Threads es la lista de cuentas que la app sugiere para un nombre o un usuario escrito, cada una identificada por su nombre de usuario, nombre visible, enlace al perfil, avatar e insignia de verificación. Esos identificadores permiten distinguir a una persona o marca real de cuentas con nombres parecidos y convertir una simple lista de nombres en perfiles de Threads confirmados.
Funcionalidades de la Threads User Search API
- Coincidencias por nombre y por usuarioquery acepta un nombre visible o un nombre de usuario, y la respuesta contiene las cuentas que Threads sugiere para él, por lo general hasta 10.
- Campos de identidad listos para usarCada coincidencia devuelve username, name y url, el enlace al perfil con el formato /@username que otros endpoints de Threads reciben como entrada.
- Insignia y avatar para desambiguaris_verified y avatar_url ayudan a elegir la cuenta auténtica cuando varias coincidencias comparten nombre.
Parámetros de la Threads User Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | El nombre de una persona o una marca, o un nombre de usuario de Threads, como shams. |
Cómo usar la Threads User Search API
Busque un nombre y lea las cuentas sugeridas.
- Envíe {"query": "shams"} por POST a /v1/threads/search-users.
- Consulte GET /v1/tasks/{task_id} con el task_id devuelto hasta que el estado sea succeeded.
- Lea las cuentas coincidentes en results.items y siga results.next_cursor siempre que has_more sea true.
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"shams"}'
# 0.6 credits for each account returned.Casos de uso de la Threads User Search API
- Confirmar un usuario antes de recopilar contenido: Revise username, el nombre visible e is_verified para dar con la coincidencia correcta y luego use su url para obtener los posts, respuestas o reposts de esa cuenta.
- Convertir una lista de nombres en perfiles de Threads: Busque cada nombre de una lista de influencers o de prensa y conserve la url de la coincidencia verificada para armar una columna de enlaces a perfiles de Threads.
- Detectar cuentas que imitan a otras: Busque una marca o una figura pública y revise las coincidencias no verificadas con nombres y avatares casi idénticos para encontrar posibles suplantaciones o páginas de fans.
Consejos de expertos para la Threads User Search API
- Pruebe tanto el nombre completo como un posible nombre de usuario cuando la cuenta que busca no aparezca en el primer grupo de coincidencias, ya que query coincide con cualquiera de los dos.
- Elija una coincidencia por username junto con is_verified en lugar de tomar la primera fila, porque los nombres comunes devuelven varias cuentas parecidas.
- Pase la url elegida directamente a Threads User Posts, User Replies o User Reposts API, que aceptan enlaces de perfil con ese mismo formato.
APIs relacionadas
Además de la Threads User 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 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.