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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Nomi 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.
- Invia con POST {"usernames": ["elonmusk", "BBCWorld"]} a /v1/x/user-about.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- 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.
API correlate
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.
- 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