XTwitterListe di XCommunity di XX SpacesGuida alle API

Nuovi endpoint dell’API di X: liste, community, Spaces, Articles e posizione dell’account

14 nuovi endpoint SocQ per X (Twitter) coprono posizione dell’account, follower verificati, verifica dei follow, liste, community, media e risposte, Articles, Spaces e trascrizioni video.

SocQAggiornato il 19 novembre 20269 min di lettura

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 il task_id restituito, interroga GET /v1/tasks/{task_id} finché status non è succeeded, poi leggi data.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.

EndpointCosa restituiscePrezzo
X Account Location APIPaese in cui ha sede l’account, come si collega a X, data di iscrizione, cambi di username0.7 crediti ($0.0035) per account
X Verified Followers APIAccount verificati che seguono un profilo0.7 crediti ($0.0035) per follower
Twitter Follow Checker APIIndicatori di follow, follow ricevuto e follow reciproco per un massimo di 100 coppie0.7 crediti ($0.0035) per coppia
X List Tweets APILa timeline di una lista, dal più recente, con i repost segnalati0.7 crediti ($0.0035) per post
Twitter List Members APIAccount presenti in una lista, come profili completi0.7 crediti ($0.0035) per membro
Twitter List Followers APIAccount che seguono una lista, come profili completi0.7 crediti ($0.0035) per follower
X Communities Search APICommunity che corrispondono a una parola chiave, con numero di membri e URL0.7 crediti ($0.0035) per community
X Community Members APIMembri di una community, come profili completi0.7 crediti ($0.0035) per membro
X Community Moderators APIAmministratori e moderatori di una community0.7 crediti ($0.0035) per moderatore
Twitter Media Scraper APIPost della scheda Media di un account, con file alla massima qualità0.7 crediti ($0.0035) per post
X User Replies APIRisposte scritte da un account, ognuna con il post a cui risponde0.7 crediti ($0.0035) per risposta
X Articles APITitolo dell’Article, riga di anteprima, testo completo, copertina e interazioni0.7 crediti ($0.0035) per Article
X Spaces APIStato dello Space, programmazione, host, speaker, ascoltatori e replay0.7 crediti ($0.0035) per Space
Twitter Video Transcript APITesto parlato del video di un post, con la sua durata0.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