x/
community-members

Esporta i membri di una community pubblica di X dal suo link, con bio, località, sito web, flag di verifica e conteggi dei follower di ogni membro, fino a 2.000 per community.

X Community Members API

Input con link della community
Un profilo per membro
Fino a 2.000 membri per community
0,7 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 Members

I membri di una community di X sono gli account che hanno scelto di entrare in una community tematica, e ognuno ha un profilo pubblico con bio, località, sito web, stato di verifica, data di creazione dell’account e numero di follower, seguiti e post. Dato che entrare in una community è una scelta consapevole legata a un unico argomento, questi profili descrivono un pubblico che si è selezionato da sé e che puoi misurare, segmentare per seguito o per luogo e confrontare con i membri di una community affine.

Funzionalità della X Community Members API

  • Elenchi dei membri dai link delle communityIncolla uno o più link https://x.com/i/communities/<id> e ogni membro di ciascuna community torna come riga di profilo a sé.
  • Chi è ogni membroLe righe contengono nome utente, nome visualizzato, bio in text, avatar, immagine di copertina, sito web e località dichiarata, così puoi riconoscere e descrivere un membro partendo solo dall’esportazione.
  • Il seguito di ogni membrometrics contiene followers_count, following_count e posts_count, che separano le voci più seguite di una community dalla sua maggioranza silenziosa.
  • Verifica e anzianità dell’accountis_verified, is_private e published_at, la data di creazione dell’account X del membro, mostrano a colpo d’occhio quanto sia consolidata ogni persona dell’elenco.

Parametri della X Community Members API

ParametriObbligatorioDescrizione
urlsObbligatorioLink di community pubbliche di X nel formato https://x.com/i/communities/<numeric_id>, uno per riga.
results_limitFacoltativoMembri da restituire per ogni community, un multiplo di 20 da 20 a 2.000. Il valore predefinito è 100.

Come usare la X Community Members API

Invia i link delle community e scorri i profili dei membri pagina per pagina.

  1. Invia con POST {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} a /v1/x/community-members.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi i profili dei membri da results.items e rimanda results.next_cursor finché has_more è true.
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":100}'

# results_limit is applied to each community in urls, so two links can return up to 200 members here.

Casi d’uso della X Community Members API

  • Tracciare il profilo del pubblico di una community: Raggruppa i membri per location.name, cerca nelle bio in text ruoli professionali e interessi e rappresenta followers_count in un grafico per descrivere chi è davvero entrato in una community.
  • Selezionare i membri per le partnership: Ordina i membri per metrics.followers_count, tieni quelli verificati e usa sito web e bio per scegliere i creator di una nicchia che vale la pena contattare.
  • Misurare la sovrapposizione tra due community: Esporta i membri di due community affini e abbinali tramite id per contare le persone che fanno parte di entrambe.
  • Controllare quanti account recenti ci sono in una community: Combina un published_at recente con valori bassi di posts_count e followers_count per vedere quale quota dei membri di una community è formata da account appena creati o poco attivi.

Consigli degli esperti per la X Community Members API

  • Invia una sola community per attività quando intendi confrontare i membri; le righe dei membri contengono solo il profilo, quindi è l’input dell’attività a collegare ogni riga alla sua community.
  • Leggi prima members_count da X Community o X Communities Search e imposta results_limit sul primo multiplo di 20 superiore per richiedere l’intero elenco in un’unica attività.
  • Normalizza location.name prima di raggruppare per Paese: contiene il luogo in testo libero scritto dal membro, come “Sydney”, e i campi della città e del Paese sono spesso vuoti.

Oltre alla X Community Members 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 API — Leggi i link delle community per descrizioni, numero di membri, regole e criteri di ingresso.
  • X Account Location API — Consulta il paese in cui si trova un account, il modo in cui si connette a X, la data di iscrizione e i cambi del nome utente.
  • 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 Members API — FAQ

X Community Members API è un’interfaccia programmatica per esportare i membri delle community pubbliche di X dai loro link /i/communities/. Restituisce un profilo per membro con nome utente, bio, località, sito web, stato di verifica e numero di follower, seguiti e post.

Sì. Il link della community è l’unico input, quindi puoi esportare i membri di una community pubblica in cui non sei mai entrato, senza alcun accesso a X.

Cerca una parola chiave con X Communities Search. Ogni risultato include l’url della community, che puoi passare a questo endpoint senza modifiche.

Fino a 2.000. results_limit accetta multipli di 20 da 20 a 2.000, ha 100 come valore predefinito e vale separatamente per ogni link di community nella richiesta.

No. published_at è la data di creazione dell’account X del membro. La data di ingresso nella community non fa parte del risultato.

Se nessuna delle community di una richiesta viene trovata, l’attività non riesce e i crediti vengono rimborsati per intero. Se ne mancano solo alcune, i membri delle altre vengono comunque restituiti.