threads/
search-users

Encuentre cuentas de Threads por nombre o nombre de usuario y obtenga las coincidencias que sugiere Threads, por lo general hasta 10, con nombre de usuario, nombre visible, URL del perfil, avatar y estado de verificación.

Threads User Search API

Nombre o nombre de usuario
Hasta unas 10 coincidencias
Estado de verificación
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 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ámetrosObligatorioDescripción
queryObligatorioEl 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.

  1. Envíe {"query": "shams"} por POST a /v1/threads/search-users.
  2. Consulte GET /v1/tasks/{task_id} con el task_id devuelto hasta que el estado sea succeeded.
  3. 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.

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.

Explorar otras plataformas

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

Threads User Search API — FAQ

Threads User Search API es una interfaz programática para encontrar cuentas de Threads a partir de un nombre o un nombre de usuario. Devuelve las cuentas que sugiere Threads, cada una con nombre de usuario, nombre visible, enlace al perfil, avatar y estado de verificación.

Por lo general hasta 10, el mismo grupo de sugerencias que Threads ofrece para el nombre o el nombre de usuario ingresado.

Los resultados de búsqueda están pensados para identificar cuentas. Envíe la url de cada coincidencia a Threads Profiles API para obtener su biografía, su sitio web y la cantidad visible de seguidores.

Cada cuenta devuelta cuesta 0.6 créditos, así que una búsqueda con 10 coincidencias cuesta 6 créditos.