X Verified Followers
X Verified Followers es la parte de la audiencia de una cuenta que lleva una marca de verificación y aparece en la propia pestaña Seguidores verificados del perfil, donde cada seguidor figura con su nombre de usuario, su nombre visible, su avatar y la fecha en que se unió a X. Como esta lista la forman creadores de contenido, marcas y usuarios de pago, muestra qué cuentas consolidadas ya prestan atención a un perfil y ofrece una muestra compacta para acciones de contacto, investigación de competidores y revisiones de la calidad de la audiencia.
Funcionalidades de la X Verified Followers API
- Seguidores de la pestaña Seguidores verificadosLas filas provienen de la misma lista que X muestra en la pestaña Seguidores verificados de un perfil, de modo que cada seguidor devuelto tiene is_verified en true.
- Las dos cuentas identificadas en cada filaactor es la cuenta consultada, related_actor es el seguidor verificado y relationship tiene el valor follower, lo que mantiene separadas las filas de varios nombres de usuario dentro de un mismo conjunto de resultados.
- Identidad del seguidor y enlace al perfilrelated_actor incluye el id, el username, el nombre visible, la url del perfil y el avatar_url de cada seguidor, datos suficientes para abrir, revisar o exportar la cuenta.
- Cuándo se unió cada seguidor a Xpublished_at en cada fila es la fecha de registro de la cuenta del seguidor verificado y distingue las cuentas veteranas de las creadas recientemente.
- Profundidad de 20 a 2,000 por nombre de usuarioresults_limit se aplica a cada nombre de usuario en pasos de 20, desde una muestra rápida de 20 cuentas hasta 2,000 seguidores verificados.
Parámetros de la X Verified Followers API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Nombres de usuario de X cuyos seguidores verificados se recopilan. Cada cuenta se recopila por separado. |
results_limit | Opcional | Cuántos seguidores verificados se devuelven por cada nombre de usuario, en múltiplos de 20 de 20 a 2,000. El valor predeterminado es 100. |
Cómo usar la X Verified Followers API
Envíe nombres de usuario, elija cuántos seguidores verificados recopilar para cada uno y luego recorra las filas por páginas.
- Envíe {"usernames": ["NASA"], "results_limit": 100} por POST a /v1/x/verified-followers.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los seguidores verificados en results.items y devuelva results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["NASA"],"results_limit":100}'
# related_actor is the verified follower; actor is the account you asked about.Casos de uso de la X Verified Followers API
- Armar una lista de contacto con la audiencia verificada de un competidor: Recopile los seguidores verificados de un rival y exporte related_actor.username y url para contactar a los creadores de contenido, las marcas y los suscriptores que ya siguen su categoría.
- Encontrar cuentas verificadas que siguen solo a un rival: Recopile en una sola tarea los seguidores verificados de su propia cuenta y los de un competidor, y conserve los valores de related_actor.id que aparecen únicamente en la lista del competidor.
- Comparar audiencias verificadas entre varios perfiles: Envíe un conjunto de nombres de usuario a la vez y compare la cantidad de filas y los related_actor.id compartidos para ver qué perfiles atraen a las mismas cuentas verificadas.
- Detectar una ola de seguidores verificados recién creados: Ordene los seguidores verificados de un perfil por published_at para ver si su audiencia con marca de verificación se apoya en cuentas veteranas o en cuentas que se unieron a X hace poco.
Consejos de expertos para la X Verified Followers API
- Empiece con results_limit en 20 para confirmar que un perfil tiene una audiencia verificada que valga la pena recopilar y luego súbalo; cada seguidor devuelto cuesta 0.7 créditos.
- Cuando un nombre de usuario devuelve exactamente results_limit filas, su lista verificada puede ser más larga, así que suba el límite hacia 2,000 para obtener un panorama más completo.
- Identifique a los seguidores por related_actor.id y compare las ejecuciones por collected_at para ver qué cuentas verificadas son nuevas desde su última revisión.
- Lea la cuenta consultada en actor.username; los demás campos de actor pueden venir vacíos, mientras que related_actor trae los datos del seguidor.
APIs relacionadas
Además de la X Verified Followers 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.
- 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 Following List API — Recolecta los perfiles seguidos por cuentas públicas de X, incluyendo identidad, biografías, señales de la cuenta, contadores visibles y nombres de usuario de origen.
- X Post Retweeters API — Recolecta, a nivel de tarea, un conjunto único de perfiles públicos normalizados de las cuentas que hicieron repost de URLs de estado conocidas de X o Twitter.
- X Account Location API — Consulta el país donde está ubicada una cuenta, cómo se conecta a X, su fecha de registro y sus cambios de nombre de usuario.
- Twitter Follow Checker API — Comprueba si una cuenta sigue a otras y si estas la siguen de vuelta.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Video Transcript API