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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Link di community pubbliche di X nel formato https://x.com/i/communities/<numeric_id>, uno per riga. |
results_limit | Facoltativo | Membri 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.
- Invia con POST {"urls": ["https://x.com/i/communities/1493446837214187523"], "results_limit": 100} a /v1/x/community-members.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- 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.
API correlate
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.
- 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 Community Posts API
- X Thread Context 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