Torna alle API
Dati pubblici di X

X Public Data API

Raccogli profili pubblici, relazioni di follower e seguiti, post, risposte, citazioni, repost, risultati di ricerca e tendenze attuali. Usa risultati coerenti per ricerca e monitoraggio.

API di X disponibili

Scegli l’API adatta al tuo punto di partenza: un nome utente, l’URL di un post, un elenco di account, una query di ricerca o un WOEID numerico noto.

Quali dati di X puoi recuperare?

Crea un dataset sull’identità degli account, su contenuti noti, sull’attività di pubblicazione recente, sulla scoperta dei post o sugli argomenti attuali legati a una località.

Profili pubblici degli account

Trasforma i nomi utente in identità del profilo, biografia, risorse visive, stato dell’account, metriche del pubblico, elenchi di follower, elenchi di seguiti e momento della raccolta.

Dettagli di post noti

Risolvi gli URL pubblici degli status in dettagli del post, risposte, citazioni, profili di chi ha fatto repost, media, relazioni ed engagement visibile.

Post recenti per account

Raccogli i post pubblici recenti, escluse le risposte, per nomi utente selezionati e confronta l’attività su un elenco di account.

Ricerca e scoperta dei post

Cerca post pubblici con una sola query, scegli l’ordinamento per più recenti o per più popolari e mantieni la query collegata a ogni risultato.

Tendenze attuali per WOEID

Raccogli un’istantanea, legata a una località, di nomi delle tendenze, posizioni nella fonte, query, descrizioni e momenti dell’osservazione.

SocQ vs prodotti per sviluppatori di X

SocQ è pensato per flussi di lavoro di ricerca coerenti sui dati pubblici. I prodotti per sviluppatori di X supportano integrazioni gestite da X, con i propri prodotti e requisiti di autorizzazione.

Flusso di lavoroEndpoint X di SocQProdotti per sviluppatori di X
Ideale perArricchimento dei profili, ricerca sui post, monitoraggio e scoperta di argomenti pubbliciIntegrazioni di applicazioni e account gestite da X
Input inizialeNomi utente, URL di status, elenchi di account, un’espressione di ricerca o WOEID notiRichieste specifiche del prodotto e contesto di un account autorizzato
AutenticazioneChiave API di SocQCredenziali per sviluppatori di X e autorizzazione applicabile
Forma dei datiRecord normalizzati di profili, post e tendenzeRisposte native di X specifiche del prodotto
Modello di elaborazioneAttività asincrona seguita dalla paginazione dei risultatiCiclo di vita di richiesta e risposta specifico del prodotto

Come funziona l’API di X

Ogni API di X usa lo stesso schema di invio, monitoraggio e recupero.

  1. 1. Invia il tuo input

    Invia nomi utente, URL di status, un elenco di account, una query di ricerca o WOEID numerici all’API corrispondente.

  2. 2. Segui l’attività

    Usa task_id con /v1/tasks/{task_id} finché l’elaborazione non è completata.

  3. 3. Recupera i risultati

    Leggi data.results.items e usa next_cursor finché has_more è true.

Inizia con una sola richiesta API

Autenticati con la tua chiave API di SocQ e invia uno o più nomi utente di X. I post diretti, i post degli utenti, la ricerca e le tendenze seguono lo stesso flusso di attività.

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 comuni dell’API di X

Ricerca su creator e partner

Arricchisci nomi utente noti, confronta i segnali pubblici degli account e crea profili di creator coerenti.

Monitoraggio di brand e mercato

Segui account selezionati, ripeti ricerche stabili o acquisisci le tendenze per WOEID noti per creare dataset con data e ora su brand, concorrenti e argomenti.

Reportistica sui contenuti delle campagne

Risolvi gli URL dei post delle campagne e organizza contenuti, autori, media, relazioni ed engagement al momento della raccolta.

Ricerca e prodotti di dati

Usa record coerenti di profili e post in data warehouse, classificatori, indici di ricerca, strumenti di revisione e dashboard.

Limiti e policy sui dati pubblici

SocQ restituisce i dati di X accessibili pubblicamente così come appaiono quando l’attività viene eseguita.

  • I contatori dei profili e l’engagement dei post sono istantanee riferite a collected_at.
  • I risultati di ricerca seguono l’ordinamento selezionato, più recenti o più popolari, al momento della raccolta.
  • Posizioni e descrizioni delle tendenze provengono dalla fonte e rappresentano il WOEID richiesto al momento della raccolta.
  • results_limit imposta un massimo, ma il numero restituito dipende dai record pubblici idonei disponibili durante l’attività.
  • Le API leggono solo dati pubblici e non pubblicano post né gestiscono account X.

Domande frequenti sull’API di X

Che cosa posso raccogliere con l’API di X?

Puoi recuperare profili pubblici, elenchi di follower e seguiti, post noti, post recenti, risposte, citazioni, profili di chi ha fatto repost, risultati di ricerca e tendenze attuali per WOEID numerici noti.

Quale API di X devo scegliere?

Usa Profiles, Followers List o Following List per gli account; Posts, Post Replies, Post Quotes o Post Retweeters per gli URL di status; User Posts per l’attività recente degli account; Search per la scoperta basata su query; e Trends per WOEID numerici noti.

Come funziona l’elaborazione delle attività?

Invia una richiesta POST, interroga /v1/tasks/{task_id}, poi leggi data.results.items e continua con next_cursor finché has_more è true.

Che cosa include ogni risultato?

I risultati includono i campi disponibili per quella API, come identità del profilo, contenuto e media dei post, oppure nome della tendenza, posizione nella fonte, WOEID, query, descrizione e momento della raccolta.

Le metriche di X sono in tempo reale?

No. I contatori degli account, l’engagement dei post e le posizioni delle tendenze sono istantanee. Usa collected_at come momento dell’osservazione quando confronti i risultati.

Quanto costa la raccolta di dati da X?

Profiles costa 0,6 crediti per risultato, i post diretti, i post degli utenti e le tendenze costano 0,5, e i risultati di ricerca costano 0,7.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.