x/
search-users

Busque cuentas públicas de usuarios de X por palabra clave y obtenga identidad normalizada, biografía, estado de verificación y métricas de audiencia.

Twitter User Search API

Búsqueda de usuarios
Descubrimiento de cuentas
Perfiles normalizados
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

Twitter User Search

Descubrir perfiles relevantes de creadores de contenido, empresas y especialistas en X requiere una coincidencia precisa de palabras clave entre los identificadores y las biografías de las cuentas. Los resultados de perfil normalizados entregan nombres de usuario, nombres visibles, biografías, contexto de ubicación, conteos de seguidores e insignias de verificación.

Funcionalidades de la Twitter User Search API

  • Coincidencia de cuentas por palabra claveEnvíe cualquier término de consulta para descubrir perfiles públicos relevantes entre nombres, nombres de usuario y biografías de cuentas.
  • Atributos de perfil normalizadosReciba objetos coherentes con el ID de usuario, el identificador, el nombre visible, el avatar, el banner y el texto de la biografía.
  • Métricas de audienciaCapture los conteos actuales de seguidores, seguidos, posts totales, contenido multimedia y favoritos de cada cuenta devuelta.
  • Indicadores de verificación y estadoIdentifique las insignias azules de verificación, los indicadores de cuentas automatizadas, el estado de cuenta protegida y las cadenas de ubicación.

Parámetros de la Twitter User Search API

ParámetrosObligatorioDescripción
queryObligatorioConsulta de búsqueda por palabra clave para encontrar perfiles públicos de usuarios de X que coincidan.
results_limitOpcionalCantidad máxima de perfiles de usuario que se devuelven; debe ser un múltiplo de 20 entre 20 y 2,000, con 20 como valor predeterminado.

Cómo usar la Twitter User Search API

Envíe una consulta de búsqueda por palabra clave como tarea asíncrona y recorra después por páginas los perfiles de usuario normalizados.

  1. Defina el término de búsqueda en query y especifique results_limit como un múltiplo de 20 (hasta 2,000).
  2. Envíe una solicitud POST a /v1/x/search-users con su clave de API de SocQ.
  3. Consulte /v1/tasks/{task_id} hasta que el estado de la tarea sea succeeded.
  4. Obtenga los registros de cuentas normalizados de data.results.items.
curl -X POST "https://api.socq.ai/v1/x/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"OpenAI","results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Casos de uso de la Twitter User Search API

  • Descubrimiento de influencers y especialistas en la materia: Encuentre especialistas influyentes del sector, periodistas y referentes de opinión buscando terminología del sector.
  • Auditoría de cuentas de marca: Descubra identificadores de marca, filiales regionales localizadas o cuentas de fans no oficiales en toda la plataforma.
  • Generación de listas de prospectos para contacto: Cree listas de prospectos de profesionales relevantes, filtradas por palabras clave en su biografía pública.

Consejos de expertos para la Twitter User Search API

  • Use este endpoint para descubrir cuentas; use X Search cuando quiera encontrar posts individuales.
  • results_limit debe ser un múltiplo de 20 (por ejemplo 20, 40 o 100) para alinearse con los lotes de paginación del origen.
  • Revise las propiedades is_verified y verified_type para confirmar si una cuenta está autenticada oficialmente.
  • Pase los nombres de usuario descubiertos a X User Posts o X Following List para explorar más a fondo el grafo de su audiencia.

Además de la Twitter User Search API, use estas APIs cuando necesite otro tipo de datos públicos de X.

  • Twitter Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
  • Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
  • Twitter Search API — Encuentra posts públicos mediante una expresión de búsqueda, con orden por más recientes o más populares y un límite de resultados configurable.
  • X Followers List API — Recolecta las identidades de las cuentas seguidoras públicas y las métricas visibles de sus perfiles para uno o más nombres de usuario de X.
  • X Trends API — Recolecta instantáneas de las tendencias públicas actuales de X para WOEIDs numéricos conocidos, con posición de origen, consulta, descripción y contexto de ubicación.
  • X Communities Search API — Encuentra comunidades por palabra clave, con el número de miembros y un enlace listo para los endpoints de miembros y posts.

Explorar otras plataformas

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

Twitter User Search API — FAQ

Twitter User Search API busca cuentas públicas de usuarios y perfiles de creadores de contenido en X mediante consultas de texto. Devuelve registros de perfil normalizados con conteos de seguidores, biografías, insignias de verificación y URL de avatares.

El endpoint X Search busca posts públicos que coinciden con palabras clave, mientras que Twitter User Search busca específicamente cuentas de usuarios y perfiles de canales.

El proveedor de origen entrega los resultados de búsqueda de usuarios en páginas fijas de 20 elementos, por lo que los límites solicitados deben ser un múltiplo exacto de 20.