x/
search-communities

Cerca le community di X per parola chiave e ottieni nome, link, immagine del banner, numero di membri e flag dei contenuti sensibili di ogni risultato, fino a 500 community per ricerca.

X Communities Search API

Input con parola chiave
Numero di membri per community
Flag dei contenuti sensibili
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 Communities Search

Le community di X sono gruppi tematici a cui le persone si uniscono su X, e nei risultati di ricerca ognuna mostra un nome, un’immagine del banner, il numero di membri e un flag che indica se è contrassegnata come sensibile. Cercare una parola chiave tra questi risultati rivela dove si discute di un argomento, quali gruppi sono i più grandi e quali portano un’etichetta per adulti o per contenuti sensibili prima ancora che qualcuno li apra.

Funzionalità della X Communities Search API

  • Una parola chiave, tutte le community corrispondentiInserisci una parola o una frase in query, come bitcoin, e le community che X elenca per quel termine tornano una per riga.
  • Nome e bannername e cover_url forniscono il titolo e l’immagine del banner di ogni community, quanto basta per riconoscerla in un elenco o mostrarla nella tua interfaccia.
  • Numero di membri per valutarne le dimensionimetrics.members_count indica quante persone si sono unite, così distingui un gruppo minuscolo da una community di decine di migliaia di membri direttamente dalla ricerca.
  • Indicatore dei contenuti sensibiliis_nsfw è true quando la community è contrassegnata come sensibile su X, così puoi gestire gli spazi per adulti prima che finiscano in un report o davanti a un utente.
  • ID e link stabiliOgni riga contiene l’id numerico della community e il suo url https://x.com/i/communities/<id>, che restano uguali tra una ricerca e l’altra e funzionano come chiave nei tuoi dati.

Parametri della X Communities Search API

ParametriObbligatorioDescrizione
queryObbligatorioLa parola chiave con cui cercare le community di X, come bitcoin.
results_limitFacoltativoQuante community restituire, un multiplo di 10 da 10 a 500. Il valore predefinito è 20.

Come usare la X Communities Search API

Cerca una parola chiave e scorri pagina per pagina le community corrispondenti.

  1. Invia con POST {"query": "bitcoin", "results_limit": 20} a /v1/x/search-communities.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi le community corrispondenti da results.items; finché has_more è true, richiedi la pagina successiva con results.next_cursor.
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}'

# Each result's url can go straight into X Community Members, X Community Moderators or X Community Posts.

Casi d’uso della X Communities Search API

  • Mappare dove vive un argomento su X: Cerca i termini principali di un mercato o di un hobby e raccogli nomi, link e numero di membri delle community che mostrano dove si concentra la conversazione.
  • Selezionare le community più grandi di una nicchia: Ordina i risultati per metrics.members_count per scegliere le poche community abbastanza grandi da meritare una sponsorizzazione, un post o un’analisi più attenta.
  • Mantenere gli elenchi di community sicuri per il brand: Scarta ogni riga in cui is_nsfw è true prima di condividere un elenco di community con un cliente o di mostrarlo all’interno di un prodotto.
  • Alimentare le esportazioni di membri e moderatori: Passa l’url di ogni community selezionata a X Community Members o X Community Moderators per passare da un elenco di gruppi alle persone che ne fanno parte.

Consigli degli esperti per la X Communities Search API

  • Prova varianti vicine di un termine, come bitcoin e btc, e unisci i risultati tramite id, perché una community può corrispondere a più parole chiave.
  • Per seguire la crescita delle community, ripeti la stessa query a intervalli programmati e salva metrics.members_count con collected_at sotto ogni id.

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

  • Twitter Search API — Trova post pubblici tramite espressione di ricerca con ordinamento per più recenti o più popolari e un limite di risultati configurabile.
  • X Trends API — Raccoglie gli snapshot attuali delle tendenze pubbliche di X per WOEID numerici noti con posizione di origine, query, descrizione e contesto della località.
  • Twitter User Search API — Trova account X pubblici per parola chiave.
  • X Community API — Leggi i link delle community per descrizioni, numero di membri, regole e criteri di ingresso.
  • 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.

Esplora altre piattaforme

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

X Communities Search API — FAQ

X Communities Search API è un’interfaccia programmatica per trovare le community di X che corrispondono a una parola chiave. Restituisce id, url, nome, immagine del banner, numero di membri e flag dei contenuti sensibili di ogni community.

Invia la parola chiave in query, per esempio bitcoin. Le community corrispondenti tornano con nomi, link e numero di membri, pronte da aprire su X o da passare a un altro endpoint dedicato alle community.

Sì, nel tuo codice. Ogni risultato include metrics.members_count, quindi raccogli prima le community corrispondenti e poi ordinale o applica una dimensione minima.

Fino a 500. results_limit accetta multipli di 10 da 10 a 500 e ha 20 come valore predefinito; leggi i risultati pagina per pagina con next_cursor.

È true quando X contrassegna la community come contenente materiale sensibile, altrimenti è false.

No. I risultati di ricerca elencano nome, banner, numero di membri e flag dei contenuti sensibili. Passa l’url a X Community API per ottenere descrizione, regole e criteri di adesione.

Nessuna community corrispondeva. L’attività riesce comunque con un risultato vuoto e non viene addebitato nulla.