x/
following-list

Raccogli i profili X pubblici seguiti da uno o più nomi utente, con identità, biografie, segnali dell’account, contatori visibili e contesto dell’account di origine.

X Following List API

Relazioni di following
Contesto del profilo
Limiti per account
0,5 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 Following List

Gli elenchi dei seguiti di X sono relazioni pubblicamente visibili tra account, che mostrano quali profili segue un account di origine, con identità, biografie, link, immagini, stato dell’account, contatori e dettagli di creazione. Questi record supportano la ricerca sulle reti di interessi, la scoperta di account, la mappatura delle relazioni e l’arricchimento dei dataset di profili.

Funzionalità della X Following List API

  • Raccolta dei seguiti di più accountAccetta uno o più nomi utente pubblici di X e applica una raccolta separata e con limite dell’elenco dei seguiti a ogni account di origine.
  • Identità e contesto del profiloRestituisce ID, nomi utente, nomi visualizzati, URL canonici, biografie, siti web, posizioni, avatar, banner e orari di creazione degli account seguiti.
  • Segnali dell’account e contatori pubbliciCombina i segnali visibili di verifica, protezione, messaggistica, post in evidenza e automazione con i conteggi di follower, seguiti, post, media e Mi piace.
  • Record normalizzati con riferimento alla fonteMantiene ogni profilo salvato in una struttura pubblica coerente con collected_at ed extra.input_username per la tracciabilità della fonte.

Parametri della X Following List API

ParametriObbligatorioDescrizione
usernamesObbligatorioArray obbligatorio di nomi utente pubblici di X non vuoti. I valori possono includere o omettere la @ iniziale.
results_limitFacoltativoNumero massimo di profili seguiti richiesti per nome utente. Il valore predefinito è 200 e sono accettati multipli di 200 da 200 a 2.000.

Come usare la X Following List API

Invia i nomi utente pubblici di origine, poi leggi i record normalizzati dei profili seguiti dall’attività asincrona completata.

  1. Prepara uno o più nomi utente pubblici di X, con o senza @ iniziale, e scegli un results_limit per nome utente che sia un multiplo di 200 da 200 a 2.000.
  2. Invia con POST usernames e results_limit a /v1/x/following-list, poi conserva il task_id restituito.
  3. Interroga GET /v1/tasks/{task_id} mentre l’attività è queued, running o retrying e fermati quando riesce o fallisce.
  4. Dopo il successo, leggi data.results.items e continua a richiedere l’attività con next_cursor finché data.results.has_more è true.
curl -X POST "https://api.socq.ai/v1/x/following-list" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@X"],"results_limit":200}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and pass next_cursor while data.results.has_more is true

Casi d’uso della X Following List API

  • Ricerca sulle reti di interessi: Collega ogni nome utente di origine conservato con identità, biografie, link e posizioni dei profili seguiti per esaminare gli interessi pubblici intorno ad account noti.
  • Scoperta di account a partire da profili seed: Usa nomi, biografie, immagini, segnali di verifica e contatori visibili per rivedere gli account candidati trovati nell’elenco pubblico dei seguiti di un profilo di origine.
  • Arricchimento degli elenchi di relazioni: Aggiungi ID stabili, URL canonici dei profili, metadati pubblici degli account, contatori e orari di raccolta ai record di relazioni esistenti basati sui nomi utente.

Consigli degli esperti per la X Following List API

  • Rimuovi le @ iniziali e deduplica i nomi utente di origine senza distinguere maiuscole e minuscole prima dell’invio, così handle equivalenti non ripetono il lavoro sull’account di origine.
  • Dimensiona results_limit per nome utente a passi di 200; con più origini, pianifica fino a usernames × results_limit record prima della fine degli elenchi e della deduplicazione a livello di attività.
  • Quando costruisci un grafo molti-a-molti, non presumere una riga salvata per ogni coppia profilo di origine e profilo seguito, perché un profilo seguito ripetuto può essere deduplicato e conservare un solo valore extra.input_username.
  • Considera un elenco vuoto o breve come un risultato legato alla visibilità pubblica e lascia che immagini, segnali di stato e contatori facoltativi restino nullable nei record a valle.
  • Non interpretare l’ordine restituito come anzianità della relazione, intensità dell’interazione o approvazione, perché la risposta espone l’ordine di raccolta e non quei segnali.

Oltre alla X Following List 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 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 Community API — Leggi i link delle community per descrizioni, numero di membri, regole e criteri di ingresso.
  • 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.

Esplora altre piattaforme

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

X Following List API — FAQ

X Following List API è un’interfaccia programmatica per raccogliere i profili pubblici seguiti da uno o più nomi utente di X. Restituisce identità normalizzata, biografie, link, immagini, segnali dell’account, contatori visibili, timestamp e contesto della fonte.

Invia un array usernames non vuoto. Ogni handle pubblico può includere o omettere una @ iniziale e i nomi utente di origine equivalenti vengono normalizzati senza distinguere maiuscole e minuscole prima della raccolta dal provider.

results_limit ha come valore predefinito 200, accetta multipli di 200 fino a 2.000 e si applica separatamente a ogni nome utente di origine. Un elenco visibile può finire prima del limite richiesto.

Un record può contenere ID del profilo, nome utente, nome visualizzato, URL canonico, biografia, sito web, posizione, avatar, banner, segnali di verifica e protezione, contatori pubblici, ora di creazione dell’account, orario di raccolta ed extra.input_username.

Non necessariamente. Le identità stabili dei profili vengono deduplicate al salvataggio dei risultati, quindi un profilo seguito da più account inviati può comparire una sola volta, con il contesto della fonte conservato in quel record salvato.

Account protetti o limitati, limiti di visibilità pubblica, pagine dell’elenco non disponibili o la fine dell’elenco visibile dei seguiti possono ridurre i record salvati. Controlla l’accessibilità pubblica dell’account di origine prima di riprovare.

No. Considera l’ordine solo come ordine di raccolta; non stabilisce quando è iniziata una relazione, quanto spesso gli account interagiscono né se la fonte approva un profilo seguito.

Ogni record di profilo normalizzato salvato costa 0,5 crediti. La fatturazione usa il numero effettivo di record salvati, quindi un risultato vuoto non ha alcun costo per unità di risultato.