x/
profiles

Trasforma uno o più nomi utente pubblici di X in record di profilo con identità, biografia, risorse visive, stato dell’account, conteggi visibili del pubblico e orario di raccolta.

Twitter Profile Scraper API

Identità del profilo
Conteggi del pubblico
Istantanee dell’account
0,6 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 Profile Scraper

Un profilo di X identifica un account pubblico tramite nome utente, nome visualizzato, biografia, URL del profilo, immagini, indicatori di stato e contatori visibili. Letti insieme in un momento di raccolta noto, questi segnali aiutano a qualificare gli account, ad arricchire le directory e a confrontare le modifiche dei profili.

Funzionalità della Twitter Profile Scraper API

  • Risoluzione da nome utente a profiloRisolve nella stessa raccolta uno o più nomi utente pubblici di X, che ogni valore includa o meno una @ iniziale.
  • Identità, biografia e immaginiCostruisce un record dell’account a partire da ID, nome utente, nome visualizzato, URL del profilo, biografia, posizione, avatar, copertina e ora di creazione.
  • Stato dell’account e dimensioni del pubblicoAbbina i segnali di verifica, privacy, messaggistica, post in evidenza e automazione ai conteggi di follower, seguiti, post, media e Mi piace.
  • Istantanee del profilo confrontabiliMantiene insieme il nome utente inviato, la data di creazione dell’account e collected_at, così le ricerche ripetute restano tracciabili nel tempo.

Parametri della Twitter Profile Scraper API

ParametriObbligatorioDescrizione
usernamesObbligatorioElenco obbligatorio di nomi utente pubblici di X. Ogni valore può includere o omettere la @ iniziale.

Come usare la Twitter Profile Scraper API

Prepara prima l’elenco degli account, poi risolvilo tramite il flusso condiviso di attività asincrone e risultati a cursore.

  1. Normalizza i nomi utente pubblici che vuoi esaminare; la @ iniziale è facoltativa.
  2. Invia con POST l’array usernames a /v1/x/profiles e conserva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività raggiunge succeeded o failed.
  4. Dopo il successo, salva data.results.items e usa next_cursor ogni volta che has_more resta true.
curl -X POST "https://api.socq.ai/v1/x/profiles" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["nasa","@OpenAI"]}'

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

Casi d’uso della Twitter Profile Scraper API

  • Valuta gli account di creator e partner: Confronta identità, biografia, stato di verifica e conteggi del pubblico in un elenco noto prima di aggiungere gli account a una shortlist.
  • Completa le directory di account: Aggiungi URL dei profili, nomi visualizzati, biografie, immagini, posizioni e contatori pubblici ai record esistenti di CRM o partner.
  • Confronta le modifiche dei profili: Ripeti le ricerche per gli stessi ID di account e usa collected_at per confrontare biografie, segnali di stato e conteggi del pubblico tra le istantanee.

Consigli degli esperti per la Twitter Profile Scraper API

  • Rimuovi la @ iniziale e deduplica i nomi utente senza distinguere maiuscole e minuscole prima di inviare un elenco di account di grandi dimensioni.
  • Salva id come chiave stabile dell’account, conservando username ed extra.input_username per la visualizzazione e la corrispondenza con la fonte.
  • Ancora ogni confronto dei conteggi di follower, post o media a collected_at, invece di trattare i contatori come valori permanenti.
  • Lascia che immagini e segnali dell’account facoltativi restino nullable, così un profilo pubblico parziale non interrompe i record a valle.

Oltre alla Twitter Profile Scraper API, usa queste API quando ti serve un altro tipo di dati pubblici di X.

  • 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 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 Media Scraper API — Raccoglie i post con foto, video e GIF di un account, con i file multimediali alla massima qualità.

Esplora altre piattaforme

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

Twitter Profile Scraper API — FAQ

Twitter Profile Scraper API recupera i record pubblici dei profili di X per uno o più nomi utente. Restituisce identità dell’account, biografia, immagini, segnali di stato, conteggi visibili del pubblico e orario di raccolta.

Invia uno o più handle pubblici nell’array usernames. Sono accettati sia nasa sia @nasa e i valori duplicati vengono normalizzati prima della raccolta.

Un record può contenere ID dell’account, nome utente, nome visualizzato, URL del profilo, biografia, posizione, avatar, copertina, stato dell’account, ora di creazione e contatori pubblici.

Trattali come valori pubblici osservati in collected_at. Salva i record ripetuti per lo stesso id quando devi confrontare le variazioni nel tempo.

Il risultato dipende dal fatto che il nome utente sia valido e accessibile pubblicamente quando la raccolta viene eseguita. Account rinominati, privati, sospesi, limitati o non disponibili possono non produrre alcun record utilizzabile.

Ogni risultato di profilo normalizzato restituito costa 0,6 crediti SocQ.