x/
user-about

Scopri il Paese o l’area geografica che X indica per un account a partire dal nome utente, insieme al modo in cui si connette a X, alla data di iscrizione, al numero di cambi del nome utente e al badge di affiliazione.

X Account Location API

Paese dell’account
Connesso tramite
Nomi utente in blocco
0,7 crediti per risultato
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

X Account Location

Il pannello “Info sull’account” di X è una breve scheda associata a ogni profilo: il Paese o l’area geografica in cui ha sede l’account, l’app store, l’app o il client web da cui si connette, la data di iscrizione, quante volte è cambiato il nome utente e l’organizzazione a cui è affiliato. Letti insieme, questi dettagli ti permettono di verificare se un account opera davvero dal luogo che i suoi contenuti lasciano intendere, di valutare i creator prima di un accordo e di individuare gruppi di account che condividono un’origine inattesa.

Funzionalità della X Account Location API

  • Il Paese che X indica per ogni accountcountry riporta il valore “Account based in” del pannello “Info sull’account” del profilo, come United States o United Kingdom.
  • Come l’account si connette a Xconnected_via indica il canale che X associa all’account, per esempio United States App Store, Android App o Web, da leggere accanto a country.
  • Data di iscrizione e cronologia dell’handlepublished_at contiene la data in cui l’account si è iscritto a X e username_changes_count conta quante volte è stato rinominato: due segnali rapidi di quanto un handle sia consolidato.
  • Affiliazione e verifica dell’identitàaffiliate_username mostra il badge dell’organizzazione presente sul profilo, come X per elonmusk o BBCNews per BBCWorld, accanto a is_identity_verified e al flag della spunta blu is_verified.
  • Una riga per nome utente in un’unica attivitàInvia un elenco di nomi utente, con o senza la @ iniziale, e ogni account torna come riga a sé con id, username, name, avatar_url e is_private insieme ai dettagli sulla sede.

Parametri della X Account Location API

ParametriObbligatorioDescrizione
usernamesObbligatorioNomi utente X da cercare, con o senza la @ iniziale. Ogni account restituisce una propria riga.

Come usare la X Account Location API

Invia i nomi utente e leggi una riga di “Info sull’account” per ogni account.

  1. Invia con POST {"usernames": ["elonmusk", "BBCWorld"]} a /v1/x/user-about.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi una riga per account da results.items e ripassa results.next_cursor finché has_more è 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.

Casi d’uso della X Account Location API

  • Verificare da dove operano gli account politici e di informazione: Analizza gli handle che alimentano un tema politico o di attualità e segnala quelli il cui country o connected_via rimanda a una parte del mondo diversa da quella del pubblico a cui si rivolgono.
  • Valutare un creator prima di una partnership a pagamento: Controlla che country corrisponda al mercato che stai pagando per raggiungere e guarda published_at e username_changes_count per individuare un handle creato di recente o rinominato spesso.
  • Raggruppare account che potrebbero essere coordinati: Raggruppa un insieme di account sospetti per country, connected_via e mese di iscrizione per far emergere blocchi creati più o meno nello stesso periodo dallo stesso luogo.
  • Contare i Paesi dietro una conversazione: Passa i nomi utente che hanno risposto a un post o lo hanno ripostato, raccolti con altri endpoint di X, e conta i valori di country per vedere da quali aree arriva la discussione.

Consigli degli esperti per la X Account Location API

  • Prima di etichettare un account come gestito dall’estero, leggi country insieme a connected_via e published_at: un campo preso da solo può trarre in inganno.
  • Salva gli account per id, perché username_changes_count mostra quanto spesso un handle può cambiare.
  • Conserva collected_at con ogni riga e ripeti più avanti la richiesta sugli stessi nomi utente per cogliere un cambio di country, connected_via o username_changes_count.
  • Abbina le righe restituite al tuo elenco di input tramite username: se alcuni account mancano, gli altri vengono comunque restituiti e quelli mancanti semplicemente non hanno una riga.

Oltre alla X Account Location API, usa queste API quando ti serve un altro tipo di dati pubblici di X.

  • Twitter Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
  • Twitter User Tweets Scraper API — Raccoglie i post pubblici recenti, autori, media, hashtag, menzioni ed engagement a partire dal nome utente, escludendo le risposte.
  • X Followers List API — Raccoglie identità degli account follower pubblici e metriche visibili dei profili per uno o più nomi utente X.
  • X Following List API — Raccoglie i profili seguiti dagli account X pubblici, inclusi identità, bio, segnali dell’account, contatori visibili e nomi utente di origine.
  • X Post Retweeters API — Raccoglie un insieme unico, a livello di attività, di profili pubblici normalizzati degli account che hanno fatto repost di URL di stato X o Twitter noti.
  • X Verified Followers API — Raccoglie gli account verificati che seguono un profilo, con nome utente, nome, avatar e data di iscrizione.

Esplora altre piattaforme

Combina i dati di X con i dati pubblici delle altre piattaforme social supportate.

X Account Location API — FAQ

X Account Location API è un’interfaccia programmatica per leggere i dettagli di “Info sull’account” degli account X a partire da un elenco di nomi utente. Restituisce il Paese o l’area geografica in cui ha sede ciascun account, il modo in cui si connette a X, la data di iscrizione, il numero di cambi del nome utente, il badge di affiliazione e i flag di verifica.

X lo mostra come “Account based in” nel pannello “Info sull’account” del profilo. Invia qui il nome utente e lo stesso valore arriva in country, così puoi controllare molti account in un’unica attività.

Indica da dove l’account si connette a X, per esempio dall’App Store di un Paese, dall’app Android o dal web. L’endpoint lo restituisce in connected_via.

X non mostra alcun Paese per alcuni account, tra cui molti account governativi e di interesse pubblico come NASA. Restituiscono comunque una riga, con gli altri campi compilati e country impostato su null.

È il valore che X stesso mostra nel pannello “Info sull’account”, restituito senza modifiche. Indica dove X considera che l’account abbia sede: è un’etichetta di X e non la posizione in tempo reale della persona che gestisce l’account.

No. La posizione in testo libero che le persone scrivono sul proprio profilo è un campo separato; Twitter Profile Scraper API la restituisce in location.