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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco 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.
- Apri la pagina pubblica della community e copia il suo link /i/communities/; prepara un link per ogni community che vuoi cercare.
- 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.
- 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.
- 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.
- 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.
API correlate
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.
- Twitter Tweet Scraper API
- Twitter User Tweets Scraper API
- Twitter Search API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter Mentions API
- Twitter User Search API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API