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.

x/profiles
Profili0,6 crediti per risultato

x/followers-list
Profili0,5 crediti per risultato

x/posts
Post0,5 crediti per risultato

x/post-retweeters
Profili0,5 crediti per risultato

x/user-posts
Post0,5 crediti per risultato

x/search
Ricerca0,7 crediti per risultato

x/following-list
Profili0,5 crediti per risultato

x/post-quotes
Post0,5 crediti per risultato

x/post-replies
Commenti0,5 crediti per risultato

x/trends
Ricerca0,5 crediti per risultato

x/mentions
Post0,7 crediti per risultato

x/search-users
Ricerca0,6 crediti per risultato

x/community
Profili0,5 crediti per risultato

x/community-posts
Post0,7 crediti per risultato

x/thread-context
Post0,5 crediti per risultato

x/user-about
Profili0,7 crediti per risultato

x/verified-followers
Profili0,7 crediti per risultato

x/list-posts
Post0,7 crediti per risultato

x/list-members
Profili0,7 crediti per risultato

x/list-followers
Profili0,7 crediti per risultato

x/community-members
Profili0,7 crediti per risultato

x/community-moderators
Profili0,7 crediti per risultato

x/search-communities
Ricerca0,7 crediti per risultato

x/article
Post0,7 crediti per risultato

x/space
Post0,7 crediti per risultato

x/user-media
Post0,7 crediti per risultato

x/user-replies
Commenti0,7 crediti per risultato

x/check-follow
Profili0,7 crediti per risultato

x/post-transcript
Post0,7 crediti per risultato
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 lavoro | Endpoint X di SocQ | Prodotti per sviluppatori di X |
|---|---|---|
| Ideale per | Arricchimento dei profili, ricerca sui post, monitoraggio e scoperta di argomenti pubblici | Integrazioni di applicazioni e account gestite da X |
| Input iniziale | Nomi utente, URL di status, elenchi di account, un’espressione di ricerca o WOEID noti | Richieste specifiche del prodotto e contesto di un account autorizzato |
| Autenticazione | Chiave API di SocQ | Credenziali per sviluppatori di X e autorizzazione applicabile |
| Forma dei dati | Record normalizzati di profili, post e tendenze | Risposte native di X specifiche del prodotto |
| Modello di elaborazione | Attività asincrona seguita dalla paginazione dei risultati | Ciclo 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. 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. Segui l’attività
Usa task_id con /v1/tasks/{task_id} finché l’elaborazione non è completata.
3. Recupera i risultati
Leggi data.results.items e usa next_cursor finché has_more è true.
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 trueCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
LinkedIn API
Recupera dati pubblici di profili, aziende, post e offerte di lavoro su LinkedIn a partire da URL noti, con campi normalizzati su identità, carriera, azienda, contenuti, engagement e offerte.
Reddit API
Recupera post e commenti pubblici di Reddit a partire da URL noti, sfoglia i post new, top o hot dei subreddit oppure cerca discussioni per parola chiave e periodo di pubblicazione.
Pinterest API
Recupera dati pubblici dei profili Pinterest, risolvi Pin noti, raccogli i Pin di profili selezionati o cerca per parola chiave per ricerche su creator, contenuti e tendenze visive.
Threads API
Recupera profili Threads pubblici, risolvi post noti o raccogli i post di profili selezionati con campi normalizzati su identità, contenuti, media, engagement e date.
Bluesky API
Recupera i profili pubblici di Bluesky, risolvi URL di post noti o raccogli una pagina di post di un account, con campi normalizzati di identità, contenuti, media, timestamp ed engagement visibile.
Snapchat API
Recupera uno Spotlight pubblico noto di Snapchat come record normalizzato con i campi disponibili su creator, didascalia, media, audio, data, durata ed engagement.