x/
user-about

Consulte el país o la región que X indica para una cuenta a partir de su nombre de usuario, junto con la forma en que se conecta a X, su fecha de registro, la cantidad de cambios de nombre de usuario y su insignia de afiliación.

X Account Location API

País de la cuenta
Conectada a través de
Nombres de usuario en lote
0.7 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

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ámetrosObligatorioDescripción
usernamesObligatorioNombres 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.

  1. Envíe {"usernames": ["elonmusk", "BBCWorld"]} por POST a /v1/x/user-about.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

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

X Account Location API — FAQ

X Account Location API es una interfaz programática para leer los datos de Acerca de esta cuenta de cuentas de X a partir de una lista de nombres de usuario. Devuelve el país o la región donde se ubica cada cuenta, cómo se conecta a X, su fecha de registro, la cantidad de cambios de nombre de usuario, la insignia de afiliación y los indicadores de verificación.

X lo muestra en el panel Acerca de esta cuenta del perfil, como “Account based in” en la interfaz en inglés. Envíe aquí el nombre de usuario y el mismo valor llega en country, así que puede revisar muchas cuentas en una sola tarea.

Describe desde dónde se conecta la cuenta a X, como la App Store de un país, la app de Android o la web. El endpoint lo devuelve en connected_via.

X no muestra un país para algunas cuentas, entre ellas muchas cuentas gubernamentales y de interés público como NASA. Aun así devuelven una fila con los demás campos completos y country en null.

Es el valor que el propio X muestra en el panel Acerca de esta cuenta, devuelto sin cambios. Indica dónde considera X que se ubica la cuenta: es una etiqueta de X y no la posición en tiempo real de la persona detrás de ella.

No. La ubicación en texto libre que las personas escriben en su perfil es un campo aparte; Twitter Profile Scraper API la devuelve en location.