Gli endpoint di SocQ per X restituivano già profili pubblici, post, timeline, ricerca, risposte, citazioni, follower e tendenze; la guida alla raccolta di dati da X/Twitter li tratta tutti. Il 2026-11-17 ne sono stati pubblicati altri 14 nella pagina della piattaforma X. Arrivano in zone di X che gli endpoint di base non coprivano: il pannello "Informazioni su questo account", le liste, i membri e i moderatori delle community, le schede Media e Risposte di un utente, gli Articles in formato lungo, gli Spaces e il parlato nei video.
Questa guida li raggruppa per attività, mostra una richiesta per ciascuno e ne indica il prezzo.
Risposta rapida: invia un corpo JSON a
POST https://api.socq.ai/v1/x/<endpoint>. Salva iltask_idrestituito, interrogaGET /v1/tasks/{task_id}finchéstatusnon èsucceeded, poi leggidata.results.items. Tutti i 14 endpoint costano 0.7 crediti ($0.0035) per risultato, con un’unica eccezione per i video lunghi in Video Transcript.
I nuovi endpoint di X in sintesi
1 credito SocQ = $0.005. Non c’è un costo base, quindi un risultato vuoto non costa nulla.
| Endpoint | Cosa restituisce | Prezzo |
|---|---|---|
| X Account Location API | Paese in cui ha sede l’account, come si collega a X, data di iscrizione, cambi di username | 0.7 crediti ($0.0035) per account |
| X Verified Followers API | Account verificati che seguono un profilo | 0.7 crediti ($0.0035) per follower |
| Twitter Follow Checker API | Indicatori di follow, follow ricevuto e follow reciproco per un massimo di 100 coppie | 0.7 crediti ($0.0035) per coppia |
| X List Tweets API | La timeline di una lista, dal più recente, con i repost segnalati | 0.7 crediti ($0.0035) per post |
| Twitter List Members API | Account presenti in una lista, come profili completi | 0.7 crediti ($0.0035) per membro |
| Twitter List Followers API | Account che seguono una lista, come profili completi | 0.7 crediti ($0.0035) per follower |
| X Communities Search API | Community che corrispondono a una parola chiave, con numero di membri e URL | 0.7 crediti ($0.0035) per community |
| X Community Members API | Membri di una community, come profili completi | 0.7 crediti ($0.0035) per membro |
| X Community Moderators API | Amministratori e moderatori di una community | 0.7 crediti ($0.0035) per moderatore |
| Twitter Media Scraper API | Post della scheda Media di un account, con file alla massima qualità | 0.7 crediti ($0.0035) per post |
| X User Replies API | Risposte scritte da un account, ognuna con il post a cui risponde | 0.7 crediti ($0.0035) per risposta |
| X Articles API | Titolo dell’Article, riga di anteprima, testo completo, copertina e interazioni | 0.7 crediti ($0.0035) per Article |
| X Spaces API | Stato dello Space, programmazione, host, speaker, ascoltatori e replay | 0.7 crediti ($0.0035) per Space |
| Twitter Video Transcript API | Testo parlato del video di un post, con la sua durata | 0.7 crediti ($0.0035) per video fino a 2 minuti |
Autenticazione e flusso asincrono delle attività
Tutte le richieste si autenticano con una chiave API. Lo stesso header vale per l’invio, lo stato dell’attività e le richieste dei risultati:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Ogni raccolta viene eseguita come attività in background:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La chiamata di invio risponde subito con data.task_id e data.status. Interroga l’attività con quell’ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Quando status è succeeded, la risposta include result_count, credits_amount e la prima pagina di record normalizzati in data.results.items. limit vale 50 per impostazione predefinita e arriva fino a 500. Se results.has_more è true, passa results.next_cursor come cursor per leggere la pagina successiva. Un’attività non riuscita riporta error_message.
Tutti gli endpoint qui sotto accettano anche un callback_url facoltativo. Al termine dell’attività SocQ invia un’unica POST con un riepilogo; i record vanno letti dall’endpoint delle attività. Un timeout lato client non annulla l’attività, quindi riprendi con lo stesso ID invece di inviarla di nuovo. Un 402 indica che l’account ha esaurito i crediti, un 429 che la chiave ha raggiunto un limite di frequenza o di crediti.
Una nota su results_limit: per Verified Followers e per gli endpoint dei membri di liste e community si applica a ogni input, vale 100 per impostazione predefinita e deve essere un multiplo di 20 tra 20 e 2000. Per Communities Search deve essere un multiplo di 10 tra 10 e 500.
Verificare account e relazioni
Account Location legge il pannello "Informazioni su questo account": country, connected_via (per esempio United States App Store o Web), data di iscrizione, username_changes_count e affiliate_username. Usalo per verificare gli influencer e individuare account coordinati. Alcuni account, come molti account governativi, non hanno un paese; restituiscono comunque una riga con country: null. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/user-about" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames": ["elonmusk", "BBCWorld"]}'
Verified Followers restituisce l’elenco che X mostra nella scheda Follower verificati. Ogni riga è un follower verificato (actor) collegato all’account richiesto (related_actor). Usalo per misurare la parte influente di un pubblico o per costruire una lista di outreach dai follower di un concorrente. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/verified-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames": ["NASA"], "results_limit": 20}'
Follow Checker confronta un username con un massimo di 100 usernames. Ogni coppia restituisce is_following, is_followed_by e is_mutual. Usalo per confermare che i partecipanti a una campagna seguano il tuo brand. (documentazione)
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"]}'
Leggere le liste di X
Tutti e tre accettano URL di liste pubbliche nel formato /i/lists/{numeric_id}.
List Tweets restituisce la timeline della lista, dal post più recente. I repost vengono mantenuti e contrassegnati con is_repost, più reposted_post_id e reposted_author, così puoi filtrarli. Con una sola richiesta monitori un’intera nicchia. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/list-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
List Members esporta gli account di una lista come profili completi con bio, località, sito web, verifica e numero di follower, account seguiti e post. Una lista curata a mano è un punto di partenza pronto per la prospezione. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/list-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
List Followers restituisce gli account iscritti a una lista, con la stessa struttura di profilo. Seguire una lista è un interesse dichiarato per il suo argomento, il che li rende un segmento di ricerca preciso. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/list-followers" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/lists/1940592907737845989"], "results_limit": 20}'
Mappare le community di X
Communities Search trova le community per parola chiave, con nome, numero di membri, banner, is_nsfw e URL della community. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/search-communities" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "bitcoin", "results_limit": 20}'
Passa l’URL di una community (/i/communities/{numeric_id}) a Community Members per ottenerne i membri come profili completi. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/community-members" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 20}'
Community Moderators restituisce l’intero team, amministratori compresi, in una sola richiesta. Sono i contatti giusti per una sponsorizzazione o un AMA. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/community-moderators" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/communities/1493446837214187523"]}'
Descrizione e regole di una community sono trattate nella guida ai dettagli delle community, i suoi post nella guida ai post delle community.
Raccogliere i media e le risposte di un account
Entrambi accettano un solo username; results_limit vale 20 per impostazione predefinita e accetta valori da 1 a 1000.
Media Scraper restituisce i post della scheda Media di un account, dal più recente, con testo, interazioni, visualizzazioni e file multimediali. I video puntano all’MP4 di qualità più alta disponibile. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/user-media" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "NASA", "results_limit": 20}'
User Replies restituisce la scheda Risposte dell’account, dalla più recente. Ogni risposta include in_reply_to con testo, autore, link e orario del post a cui risponde, così ogni riga si legge come uno scambio completo. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/user-replies" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "elonmusk", "results_limit": 20}'
Per le conversazioni complete, consulta la guida al contesto dei thread.
Leggere Articles, Spaces e il parlato dei video
Articles accetta l’URL del post che pubblica un Article (/{username}/status/{post_id}) e restituisce title, la riga di anteprima come summary, il testo completo in text, immagine di copertina, autore e like, risposte, citazioni e visualizzazioni. Un post che non è un Article non restituisce righe; se nessuno degli URL è un Article, l’attività non riesce e non viene addebitata. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/article" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/USDOL/status/2119796255089947070"]}'
Spaces accetta link /i/spaces/{space_id}. Ogni Space restituisce titolo, status (programmato, in diretta o terminato), scheduled_start_at, host, speaker, ascoltatori in diretta, visualizzazioni del replay e is_replay_available. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/space" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/i/spaces/1OdWgBerXWvaQz"]}'
Video Transcript trasforma il parlato del video di un post in testo semplice, con duration_seconds. Un video fino a 2 minuti costa 0.7 crediti. Un video più lungo costa 4 crediti ($0.02) per ogni minuto iniziato della sua durata totale, quindi un video di 3 minuti costa 12 crediti ($0.06). I post senza video non restituiscono righe e non vengono addebitati. (documentazione)
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls": ["https://x.com/NASA/status/2119833829389041896"]}'
Guide correlate su X
Per confrontare SocQ con altri fornitori di dati di X e con l’API ufficiale, leggi Prezzi dell’API di Twitter e le migliori alternative all’API di X, Le 7 migliori API scraper per Twitter/X e Alternative a TwitterAPI.io.
Domande frequenti (FAQ)
Cosa restituisce la X Account Location API quando X non indica un paese?
Una riga con country impostato a null. Gli altri campi, come connected_via e la data di iscrizione, vengono comunque restituiti.
Perché results_limit deve essere un multiplo di 20?
È la regola per Verified Followers, List Tweets, List Members, List Followers e Community Members: da 20 a 2000 a passi di 20, applicata a ogni input. Communities Search usa passi di 10 da 10 a 500.
Pago per i post che non sono Articles o che non hanno un video?
No. Quei post non restituiscono righe e paghi solo le righe restituite. Se nessuno degli URL inviati all’Articles API è un Article, l’attività non riesce e non viene addebitata.
Quanto costa la trascrizione di un video lungo?
Fino a 2 minuti: 0.7 crediti. Oltre: 4 crediti per ogni minuto iniziato della durata totale, quindi 3 minuti costano 12 crediti e 5 minuti 20 crediti ($0.10).
Posso verificare molte relazioni di follow in una volta?
Sì. Follow Checker confronta un account con un massimo di altri 100 in una sola richiesta, con un addebito di 0.7 crediti per coppia.
X API
Prova il flusso di lavoro con un URL pubblico di X
Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.
Scopri le API di X