X Account Location
El panel Acerca de esta cuenta de X es una ficha breve vinculada a cada perfil: el país o la región donde se ubica la cuenta, la tienda de aplicaciones, la app o el cliente web desde el que se conecta, la fecha en que se unió, cuántas veces cambió su nombre de usuario y la organización a la que está afiliada. Leídos en conjunto, estos datos permiten comprobar si una cuenta opera desde donde sugiere su contenido, evaluar a creadores de contenido antes de un acuerdo y encontrar grupos de cuentas que comparten un origen inesperado.
Funcionalidades de la X Account Location API
- El país que X indica para cada cuentacountry contiene el valor “Account based in” (el país donde se ubica la cuenta) del panel Acerca de esta cuenta del perfil, como United States o United Kingdom.
- Cómo llega la cuenta a Xconnected_via nombra el canal que X asocia con la cuenta, por ejemplo United States App Store, Android App o Web, y puede leerse junto a country.
- Fecha de registro e historial del nombre de usuariopublished_at guarda la fecha en que la cuenta se unió a X y username_changes_count cuenta sus cambios de nombre: dos señales rápidas de qué tan consolidada está una cuenta.
- Afiliación y verificación de identidadaffiliate_username muestra la insignia de organización del perfil, como X para elonmusk o BBCNews para BBCWorld, junto a is_identity_verified y al indicador de marca azul is_verified.
- Una fila por nombre de usuario en una sola tareaEnvíe una lista de nombres de usuario, con la @ inicial opcional, y cada cuenta vuelve como una fila propia con id, username, name, is_private y avatar_url, además de sus datos de ubicación.
Parámetros de la X Account Location API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
usernames | Obligatorio | Nombres de usuario de X que se consultan, con o sin la @ inicial. Cada cuenta devuelve su propia fila. |
Cómo usar la X Account Location API
Envíe nombres de usuario y lea una fila de Acerca de esta cuenta por cada cuenta.
- Envíe {"usernames": ["elonmusk", "BBCWorld"]} por POST a /v1/x/user-about.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea una fila por cuenta en results.items y devuelva results.next_cursor mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/user-about" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["elonmusk","BBCWorld"]}'
# An account that shows no country on X still returns a row, with country set to null.Casos de uso de la X Account Location API
- Verificar desde dónde operan cuentas políticas y de noticias: Consulte las cuentas que impulsan un tema político o de noticias y marque aquellas cuyo country o connected_via apunta a una región del mundo distinta de la del público al que se dirigen.
- Evaluar a un creador de contenido antes de una alianza pagada: Confirme que country coincide con el mercado al que paga por llegar y revise published_at y username_changes_count para detectar una cuenta creada hace poco o renombrada con frecuencia.
- Agrupar cuentas que podrían actuar de forma coordinada: Agrupe un conjunto de cuentas sospechosas por country, connected_via y mes de registro para descubrir lotes creados en la misma época desde el mismo lugar.
- Contar los países detrás de una conversación: Envíe los nombres de usuario que respondieron a un post o le hicieron repost, recopilados con otros endpoints de X, y cuente los valores de country para ver de qué regiones proviene la conversación.
Consejos de expertos para la X Account Location API
- Antes de calificar una cuenta como operada desde el extranjero, lea country junto con connected_via y published_at; un solo campo por sí mismo puede inducir a error.
- Guarde las cuentas por id, ya que username_changes_count muestra con qué frecuencia puede cambiar un nombre de usuario.
- Conserve collected_at con cada fila y vuelva a consultar los mismos nombres de usuario más adelante para detectar un cambio en country, connected_via o username_changes_count.
- Relacione las filas devueltas con su lista de entrada por username: cuando faltan algunas cuentas, el resto se devuelve igual y las faltantes simplemente quedan fuera de los resultados.
APIs relacionadas
Además de la X Account Location 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.
- 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 Verified Followers API — Recolecta las cuentas verificadas que siguen un perfil, con su nombre de usuario, nombre visible, foto de perfil y fecha de registro.
- Twitter Tweet 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 Follow Checker API
- Twitter Video Transcript API