x/
community

Leggi i dettagli pubblici delle community di X dai link delle community, comprese descrizioni, numero di membri e regole, con la possibilità di cercare più community alla volta.

X Community API

Dettagli della community
Conteggi di membri e moderatori
Regole e criteri di adesione
0,5 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

X Community

Una community di X è uno spazio di discussione tematico con nome, descrizione, conteggi dei membri e regole di partecipazione. Questi dettagli aiutano a capire l’argomento della community, a confrontarne le dimensioni con altre e a controllarne le regole di partecipazione prima di esplorare le discussioni.

Funzionalità della X Community API

  • Capisci di cosa parla una communityOttieni insieme nome, descrizione pubblica, link, immagine di copertina e informazioni sul creatore della community, così puoi identificare lo spazio e leggerne l’argomento dichiarato prima di cercare i post.
  • Vedi le dimensioni e i criteri di partecipazioneRicevi i conteggi di membri e moderatori insieme a join_policy e invites_policy, che descrivono come vengono gestiti l’adesione e gli inviti dei membri.
  • Leggi le regole della communityL’elenco delle regole include nomi e descrizioni delle regole, così puoi tenere i requisiti di partecipazione accanto alle informazioni di base della community.

Parametri della X Community API

ParametriObbligatorioDescrizione
urlsObbligatorioElenco obbligatorio di link pubblici di community di X con un ID numerico della community, come https://x.com/i/communities/1493446837214187523; nel Playground inserisci un link per riga, oppure nel codice usa un array JSON urls, e non il link di un profilo, di una ricerca o di un singolo post.

Come usare la X Community API

La richiesta avvia un’attività di raccolta in background, quindi la prima risposta contiene un ID attività e non i dati finali; usa quell’ID per controllare l’avanzamento e recuperare i risultati.

  1. Apri la pagina pubblica della community e copia il suo link /i/communities/; prepara un link per ogni community che vuoi cercare.
  2. Prima di eseguire l’esempio, sostituisci $SOCQ_API_KEY con la tua chiave API oppure imposta quella variabile d’ambiente. Invia l’input JSON a POST /v1/x/community con l’intestazione Authorization mostrata qui sotto, poi salva il task_id dalla risposta.
  3. Usa GET /v1/tasks/{task_id} con l’ID salvato per controllare l’avanzamento. queued significa in attesa, running significa raccolta in corso e retrying significa che è in corso un nuovo tentativo. Attendi succeeded prima di leggere i risultati; se l’attività è failed, leggi error_message per conoscere il motivo.
  4. Quando l’attività riesce, leggi data.results.items: ogni elemento di questo elenco descrive i dettagli di una community. Un elenco vuoto significa che l’attività è terminata senza restituire alcun record.
  5. Se data.results.has_more è true, il valore next_cursor è il segnaposto per un’altra pagina di risultati salvati. Copialo senza modifiche nel parametro cursor di GET /v1/tasks/{task_id}?cursor=... e continua finché has_more è false.
curl -X POST "https://api.socq.ai/v1/x/community" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://x.com/i/communities/1493446837214187523"]}'

Casi d’uso della X Community API

  • Crea una directory di community da esplorare: Inserisci nomi, descrizioni, link e numero di membri delle community in una tabella, così una persona può confrontare le community fornite per argomento e dimensione prima di decidere quali discussioni leggere.
  • Conserva le regole di partecipazione insieme alla revisione di una discussione: Salva le regole e i criteri di adesione sotto l’ID della community, poi usa separatamente X Community Posts per collegare a quel contesto i post che vuoi rivedere.

Consigli degli esperti per la X Community API

  • Se parti da un post e non dalla pagina di una community, trova prima il link pubblico della community, perché questa ricerca non determina la community di un post a partire dall’URL del post.
  • Quando la stessa community compare con link x.com e twitter.com, usa l’ID numerico dopo /i/communities/ come chiave di corrispondenza, così non crei voci duplicate nella directory.
  • Quando confronti le community, usa il numero di membri come misura delle dimensioni e non come prova di quanto attivamente i membri pubblichino; questo risultato non contiene cronologia delle attività né un elenco dei singoli membri.

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

  • Twitter Profile Scraper API — Recupera identità dell’account pubblico, bio, avatar, immagini di copertina, stato dell’account e statistiche visibili del pubblico a partire dal nome utente.
  • 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 Community Posts API — Leggi i post pubblici condivisi in una community, con testo, autori e conteggi delle interazioni.
  • X Community Members API — Esporta i membri di una community come profili completi con bio e numero di follower.
  • X Community Moderators API — Ottiene gli amministratori e i moderatori che gestiscono una community, come profili completi.

Esplora altre piattaforme

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

X Community API — FAQ

X Community API è un’interfaccia programmatica per recuperare le informazioni pubbliche delle community di X da un elenco di link. Restituisce nomi delle community, descrizioni, conteggi di membri e moderatori, regole e criteri di adesione, così puoi capire ogni community prima di esplorarne i post.

Il link di una community contiene /i/communities/ seguito da un ID numerico. Il link di un profilo punta a un account e un link /status/ punta a un post, quindi nessuno dei due è l’input per questa ricerca.

No. Un conteggio indica quanti membri ha la community, non chi siano; la risposta non contiene un elenco dei membri.

No. Questa ricerca restituisce la descrizione, le regole e altri metadati della community. Usa lo stesso link della community con X Community Posts quando ti servono le discussioni vere e proprie.

No. Le community di X sono spazi organizzati intorno ad argomenti di discussione condivisi. Le Community Notes sono annotazioni sui post e quelle annotazioni non sono l’oggetto restituito qui.

Ogni record di community restituito costa 0,5 crediti, senza costo di base. Per esempio, quattro link di community inviati stimano 2 crediti e quattro record di community restituiti costano 2 crediti.