x/
search-communities

X-Communities per Keyword durchsuchen und zu jedem Treffer Name, Link, Bannerbild, Mitgliederzahl und Kennzeichnung für sensible Inhalte erhalten, mit bis zu 500 Communities pro Suche.

X Communities Search API

Keyword als Eingabe
Mitgliederzahl pro Community
Kennzeichnung sensibler Inhalte
0,7 Credits pro Ergebnis
Bereit
Bereit

Geben Sie Parameter ein und senden Sie eine Anfrage. Aufgabenstatus und normalisierte Ergebnisse erscheinen hier.

README

Von SocQ · Aktualisiert am

X Communities Search

X-Communities sind Themengruppen, denen Menschen auf X beitreten, und in einer Suchliste zeigt jede davon einen Namen, ein Bannerbild, eine Mitgliederzahl und eine Kennzeichnung, ob sie als sensibel markiert ist. Wer ein Keyword auf diese Einträge anwendet, sieht, wo ein Thema diskutiert wird, welche Gruppen am größten sind und welche ein Label für Erwachseneninhalte oder sensible Inhalte tragen, bevor jemand sie öffnet.

Funktionen der X Communities Search API

  • Ein Keyword, alle passenden CommunitiesGeben Sie ein Wort oder eine Wortgruppe in query ein, etwa bitcoin, und die Communities, die X dazu auflistet, kommen jeweils als eigene Zeile zurück.
  • Name und Bannername und cover_url liefern Titel und Bannerbild jeder Community – genug, um sie in einer Liste wiederzuerkennen oder in Ihrer eigenen Oberfläche anzuzeigen.
  • Mitgliederzahl zur Größeneinschätzungmetrics.members_count gibt an, wie viele Personen beigetreten sind, sodass sich eine winzige Gruppe und eine Community mit Zehntausenden Mitgliedern direkt in der Suche unterscheiden lassen.
  • Markierung für sensible Inhalteis_nsfw ist true, wenn die Community auf X als sensibel markiert ist, sodass Sie Bereiche für Erwachsene behandeln können, bevor sie in einem Bericht oder bei einem Nutzer landen.
  • Stabile ID und LinkJede Zeile enthält die numerische id der Community und ihre url der Form https://x.com/i/communities/<id>, die über Suchen hinweg gleich bleiben und als Schlüssel in Ihren eigenen Daten dienen.

Parameter der X Communities Search API

ParameterErforderlichBeschreibung
queryErforderlichDas Keyword, nach dem X-Communities durchsucht werden, etwa bitcoin.
results_limitOptionalWie viele Communities zurückgegeben werden, ein Vielfaches von 10 von 10 bis 500. Standard ist 20.

So verwenden Sie die X Communities Search API

Suchen Sie nach einem Keyword und blättern Sie durch die passenden Communities.

  1. Senden Sie {"query": "bitcoin", "results_limit": 20} per POST an /v1/x/search-communities.
  2. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat.
  3. Lesen Sie die passenden Communities aus results.items; solange has_more true ist, fordern Sie die nächste Seite mit results.next_cursor an.
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.

Anwendungsfälle der X Communities Search API

  • Kartieren, wo ein Thema auf X stattfindet: Suchen Sie nach den wichtigsten Begriffen eines Marktes oder Hobbys und sammeln Sie die Namen, Links und Mitgliederzahlen der Communities, die zeigen, wo sich die Diskussion bündelt.
  • Die größten Communities einer Nische vorauswählen: Sortieren Sie die Treffer nach metrics.members_count, um die wenigen Communities auszuwählen, die groß genug für ein Sponsoring, einen Post oder einen genaueren Blick sind.
  • Community-Listen markensicher halten: Entfernen Sie jede Zeile, bei der is_nsfw true ist, bevor eine Liste von Communities an einen Kunden geht oder in einem Produkt angezeigt wird.
  • Mitglieder- und Moderatorenexporte speisen: Übergeben Sie die url jeder vorausgewählten Community an X Community Members oder X Community Moderators, um von einer Liste von Gruppen zu den Personen darin zu gelangen.

Profi-Tipps zur X Communities Search API

  • Suchen Sie nach nahen Varianten eines Begriffs, etwa bitcoin und btc, und führen Sie die Ergebnisse über id zusammen, denn eine Community kann zu mehreren Keywords passen.
  • Um das Wachstum von Communities zu verfolgen, wiederholen Sie dieselbe query regelmäßig und speichern Sie metrics.members_count mit collected_at unter jeder id.

Ergänzend zur X Communities Search API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher X-Daten benötigen.

  • Twitter Search API — Öffentliche Posts per Suchausdruck finden – mit Sortierung nach neuesten oder beliebtesten Posts und konfigurierbarem Ergebnislimit.
  • X Trends API — Aktuelle öffentliche X-Trend-Momentaufnahmen für bekannte numerische WOEIDs erfassen – mit Quellrang, Suchbegriff, Beschreibung und Ortskontext.
  • Twitter User Search API — Öffentliche X-Konten per Keyword finden.
  • X Community API — Aus Community-Links Beschreibung, Mitgliederzahlen, Regeln und Beitrittsregeln auslesen.
  • X Community Posts API — Die in einer Community geteilten öffentlichen Posts auslesen – mit Text, Autoren und Interaktionszahlen.
  • X Community Members API — Die Mitglieder einer Community als vollständige Profile mit Bio und Follower-Zahlen exportieren.

Weitere Plattformen entdecken

Kombinieren Sie X-Daten mit öffentlichen Daten anderer unterstützter Social-Media-Plattformen.

X Communities Search API — FAQ

X Communities Search API ist eine Programmierschnittstelle, mit der Sie X-Communities finden, die zu einem Keyword passen. Sie liefert id, url, Name, Bannerbild, Mitgliederzahl und Kennzeichnung für sensible Inhalte jeder Community.

Senden Sie das Keyword in query, zum Beispiel bitcoin. Die passenden Communities kommen mit Namen, Links und Mitgliederzahlen zurück, bereit zum Öffnen auf X oder zur Übergabe an einen anderen Community-Endpunkt.

Ja, in Ihrem eigenen Code. Jedes Ergebnis enthält metrics.members_count; sammeln Sie also zuerst die Treffer und sortieren Sie sie dann oder legen Sie eine Mindestgröße fest.

Bis zu 500. results_limit akzeptiert Vielfache von 10 von 10 bis 500, Standard ist 20; lesen Sie die Ergebnisse Seite für Seite mit next_cursor.

Der Wert ist true, wenn X die Community als Community mit sensiblen Inhalten markiert, sonst false.

Nein. Suchergebnisse enthalten Name, Banner, Mitgliederzahl und Kennzeichnung für sensible Inhalte. Übergeben Sie die url an die X Community API, um Beschreibung, Regeln und Beitrittsrichtlinien zu erhalten.

Keine Community passte dazu. Die Aufgabe ist trotzdem erfolgreich, mit einem leeren Ergebnis, und es wird nichts berechnet.