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ámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Consulta de búsqueda por palabra clave para encontrar perfiles públicos de usuarios de X que coincidan. |
results_limit | Opcional | Cantidad 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.
- Defina el término de búsqueda en query y especifique results_limit como un múltiplo de 20 (hasta 2,000).
- Envíe una solicitud POST a /v1/x/search-users con su clave de API de SocQ.
- Consulte /v1/tasks/{task_id} hasta que el estado de la tarea sea succeeded.
- 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.
APIs relacionadas
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.
- Twitter Tweet Scraper API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API