x/
check-follow

Verifica se un account X segue fino a 100 altri account e se ognuno di questi lo segue a sua volta, con is_following, is_followed_by e is_mutual per ogni coppia di nomi utente.

Twitter Follow Checker API

Entrambe le direzioni del follow
Fino a 100 coppie per attività
Flag del follow reciproco
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

Twitter Follow Checker

Un follow su X, l’ex Twitter, è un collegamento a senso unico da un account a un altro, quindi due account qualsiasi si trovano sempre in uno di quattro stati: nessuno dei due segue l’altro, il primo segue il secondo, il secondo segue il primo oppure si seguono a vicenda. Sapere in quale stato si trova una coppia risponde a domande di tutti i giorni, come se i partecipanti a un concorso seguono un brand, se un partner ha ricambiato il follow e quanto sono legati tra loro i creator di un gruppo.

Funzionalità della Twitter Follow Checker API

  • Un account a confronto con fino a 100 altriInserisci l’account da verificare in username e fino a 100 account in usernames: ogni abbinamento torna come riga a sé con source_username e target_username.
  • Entrambe le direzioni e il follow reciproco in una rigais_following indica se username segue l’altro account, is_followed_by indica se quell’account lo segue a sua volta e is_mutual è true quando valgono entrambe le condizioni.
  • Chiave della coppia e link al profiloid ha la forma source_username:target_username e url rimanda al profilo del target, così le righe si collegano in modo pulito ai tuoi elenchi e si aprono con un clic.

Parametri della Twitter Follow Checker API

ParametriObbligatorioDescrizione
usernameObbligatorioL’account X da verificare, confrontato con ogni account presente in usernames.
usernamesObbligatorioFino a 100 nomi utente X da confrontare con username. Ognuno restituisce una riga per la sua coppia.

Come usare la Twitter Follow Checker API

Invia un account e gli account con cui confrontarlo, poi leggi una riga per ogni coppia.

  1. Invia con POST {"username": "elonmusk", "usernames": ["SpaceX", "NASA"]} a /v1/x/check-follow.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi ogni coppia da results.items e ripassa results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/x/check-follow" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"elonmusk","usernames":["SpaceX","NASA"]}'

# is_following: elonmusk follows the target; is_followed_by: the target follows elonmusk back.

Casi d’uso della Twitter Follow Checker API

  • Verificare il requisito di follow per i partecipanti a un giveaway: Inserisci l’account del brand in username e fino a 100 partecipanti in usernames, poi tieni i partecipanti con is_followed_by uguale a true.
  • Trovare i partner che non hanno ancora ricambiato il follow: Confronta il tuo account con i creator o i brand che segui ed elenca le coppie in cui is_following è true e is_followed_by è false.
  • Mappare i collegamenti all’interno di un gruppo di creator: Usa a turno ogni membro come username rispetto al resto del gruppo e sfrutta is_mutual per disegnare chi è collegato con chi.
  • Osservare quali brand concorrenti segue un account chiave: Confronta l’account di un dirigente o di un giornalista con un elenco di concorrenti e ripeti la verifica più avanti per vedere quando cambia is_following.

Consigli degli esperti per la Twitter Follow Checker API

  • Per elenchi più lunghi di 100, elimina i duplicati, dividili in batch da 100 e unisci i risultati tramite id.
  • Registra come non verificato un target senza riga restituita e tienilo separato dalle coppie riportate come false; solo gli account trovati producono una riga.
  • Salva collected_at con ogni coppia e ripeti la stessa verifica più avanti; il confronto tra le esecuzioni mostra i nuovi follow e gli unfollow.

Oltre alla Twitter Follow Checker 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 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.

Twitter Follow Checker API — FAQ

Twitter Follow Checker API è un’interfaccia programmatica per verificare le relazioni di follow tra un account X e fino a 100 altri, usando solo i nomi utente. Per ogni coppia indica se il primo account segue il secondo, se viene seguito a sua volta e se il follow è reciproco.

Inserisci il primo account in username e il secondo in usernames. is_following ti dice se il primo segue il secondo, mentre is_followed_by risponde alla domanda inversa nella stessa riga.

Inserisci il tuo handle in username e il suo in usernames. is_followed_by impostato su true significa che ti segue, e una sola attività può coprire fino a 100 account.

Leggi is_mutual. È true solo quando ciascun account segue l’altro.

Un account in username a confronto con fino a 100 in usernames, con una riga per coppia. Dividi gli elenchi più lunghi su più attività.

Le verifiche riguardano gli account pubblici, tramite nome utente. Gli account protetti tengono nascosti i propri elenchi di follow su X, quindi le coppie che li coinvolgono non possono essere confermate.

Non con questo endpoint, che riporta solo le coppie che invii. Per gli elenchi completi usa X Following List API o X Followers List API.