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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
query | Obbligatorio | La parola chiave con cui cercare le community di X, come bitcoin. |
results_limit | Facoltativo | Quante 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.
- Invia con POST {"query": "bitcoin", "results_limit": 20} a /v1/x/search-communities.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- 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.
API correlate
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.
- Twitter Tweet Scraper API
- Twitter Profile Scraper API
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Replies API
- X Post Retweeters API
- Twitter Mentions 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 Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API