X Verified Followers
X Verified Followers è la parte del pubblico di un account che ha la spunta di verifica, elencata nella scheda “Follower verificati” del profilo, dove ogni follower compare con handle, nome visualizzato, avatar e data di iscrizione a X. Dato che questo elenco è composto da creator, brand e utenti abbonati, mostra quali account affermati seguono già un profilo e offre un campione compatto per i contatti commerciali, l’analisi della concorrenza e le verifiche sulla qualità del pubblico.
Funzionalità della X Verified Followers API
- I follower della scheda Follower verificatiLe righe provengono dallo stesso elenco che X mostra nella scheda “Follower verificati” di un profilo, quindi ogni follower restituito ha is_verified impostato su true.
- Entrambi gli account indicati in ogni rigaactor è l’account che hai richiesto, related_actor è il follower verificato e relationship vale follower: così le righe di più nomi utente restano distinte in un unico insieme di risultati.
- Identità del follower e link al profilorelated_actor fornisce id, username, nome visualizzato, url del profilo e avatar_url di ogni follower, quanto basta per aprire, esaminare o esportare l’account.
- Quando ogni follower si è iscritto a Xpublished_at in ogni riga è la data di iscrizione dell’account del follower verificato e distingue gli account di lunga data da quelli creati di recente.
- Da 20 a 2.000 per nome utenteresults_limit si applica a ogni nome utente a passi di 20, da un campione rapido di 20 account fino a 2.000 follower verificati.
Parametri della X Verified Followers API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Nomi utente X di cui raccogliere i follower verificati. Ogni account viene raccolto separatamente. |
results_limit | Facoltativo | Quanti follower verificati restituire per ogni nome utente, un multiplo di 20 da 20 a 2.000. Il valore predefinito è 100. |
Come usare la X Verified Followers API
Invia i nomi utente, scegli quanti follower verificati raccogliere per ciascuno e scorri le righe pagina per pagina.
- Invia con POST {"usernames": ["NASA"], "results_limit": 100} a /v1/x/verified-followers.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi i follower verificati da results.items e ripassa results.next_cursor finché has_more è 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.Casi d’uso della X Verified Followers API
- Creare una lista di contatti dal pubblico verificato di un concorrente: Raccogli i follower verificati di un concorrente ed esporta related_actor.username e url per contattare i creator, i brand e gli abbonati che seguono già il tuo settore.
- Trovare gli account verificati che seguono solo un concorrente: Raccogli in un’unica attività i follower verificati del tuo account e di quello di un concorrente, poi tieni i valori di related_actor.id che compaiono solo nell’elenco del concorrente.
- Confrontare il pubblico verificato di più profili: Invia insieme un gruppo di nomi utente e confronta il numero di righe e i valori di related_actor.id in comune per capire quali profili attirano gli stessi account verificati.
- Individuare un’ondata di follower verificati appena creati: Ordina i follower verificati di un profilo per published_at per capire se il suo pubblico con la spunta si basa su account di lunga data o su account iscritti a X di recente.
Consigli degli esperti per la X Verified Followers API
- Parti con results_limit a 20 per confermare che un profilo abbia un pubblico verificato che valga la pena raccogliere, poi alza il valore; ogni follower restituito costa 0,7 crediti.
- Quando un nome utente restituisce esattamente results_limit righe, il suo elenco verificato potrebbe essere più lungo: alza il limite verso 2.000 per un quadro più completo.
- Usa related_actor.id come chiave dei follower e confronta le esecuzioni tramite collected_at per vedere quali account verificati sono nuovi rispetto all’ultimo controllo.
- Leggi l’account richiesto da actor.username; gli altri campi di actor possono essere vuoti, mentre related_actor contiene i dettagli del follower.
API correlate
Oltre alla X Verified Followers 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.
- 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 Account Location API — Consulta il paese in cui si trova un account, il modo in cui si connette a X, la data di iscrizione e i cambi del nome utente.
- Twitter Follow Checker API — Verifica se un account ne segue altri e se questi lo seguono a loro volta.
- 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