Reddit Subreddit Details
Subreddits bilden spezialisierte, themenbasierte Communities mit eigenen Moderationsrichtlinien, eigener Aktivität der Mitwirkenden und eigener Reichweite. Die Erfassung von Subreddit-Metadaten liefert Abonnentenzahlen, Schätzungen zu wöchentlich aktiven Nutzern, Community-Regeln und Icon-Bilder.
Funktionen der Reddit Subreddit Details API
- Größe und Aktivität der CommunityErmitteln Sie für jedes Subreddit die Gesamtzahl der Abonnenten, die wöchentlich aktiven Nutzer und die Zahl der wöchentlichen Beiträge.
- Extraktion der ModerationsregelnRufen Sie die vollständigen Community-Richtlinien im Markdown-Format und die Regeln für Beiträge ab, die die Teilnahme der Nutzer regeln.
- Branding und visuelle ElementeErfassen Sie Icon-Bilder der Community, Headergrafiken, Anzeigenamen und Einordnungen in Werbekategorien.
- Stapelabfrage mehrerer URLsSenden Sie ein Array mit /r/{subreddit}-URLs in einer einzigen Anfrage für eine gebündelte Analyse von Communities.
Parameter der Reddit Subreddit Details API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Array öffentlicher Reddit-Community-URLs der Form /r/{subreddit}, für die Metadaten abgerufen werden. |
So verwenden Sie die Reddit Subreddit Details API
Senden Sie eine oder mehrere Subreddit-URLs als asynchrone Aufgabe und fragen Sie anschließend die normalisierten Community-Profile ab.
- Bereiten Sie einen oder mehrere öffentliche Subreddit-Links vor, zum Beispiel https://www.reddit.com/r/technology/.
- Senden Sie eine POST-Anfrage mit dem Array urls an /v1/reddit/subreddit-details.
- Fragen Sie /v1/tasks/{task_id} ab, bis der Status succeeded lautet.
- Lesen Sie data.results.items, um die normalisierten Community-Metadaten abzurufen.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/technology/"]}'
# Poll GET /v1/tasks/{task_id}, then inspect data.results.items.Anwendungsfälle der Reddit Subreddit Details API
- Einschätzung der Zielgruppengröße eines Subreddits: Bewerten Sie Abonnentenzahlen und wöchentlich aktive Mitwirkende, bevor Sie organische Ansprache oder AMAs starten.
- Prüfung der Regelkonformität: Werten Sie Community-Regeln programmatisch aus, damit Beiträge von Nutzern zu den Veröffentlichungsrichtlinien passen.
- Aufbau eines Themenverzeichnisses: Pflegen Sie einen aktuellen Katalog von Reddit-Communities mit kategorisierten Beschreibungen und Icons.
Profi-Tipps zur Reddit Subreddit Details API
- URLs müssen auf die Startseite der Community zeigen (zum Beispiel /r/technology/) und nicht auf einzelne Beitrags-Threads.
- Die Felder weekly_active_users und weekly_contributions in den zusätzlichen Metadaten (extra) sind verlässliche Indikatoren für den Zustand einer Community.
- Subreddit-Namen bleiben in den Feldern display_name und name in ihrer ursprünglichen Groß- und Kleinschreibung erhalten.
- Kombinieren Sie den Endpunkt mit Reddit Subreddit Posts, um aktuelle Inhalte aus Communities zu ziehen, die Ihre Größenkriterien erfüllen.
Verwandte APIs
Ergänzend zur Reddit Subreddit Details API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Reddit-Daten benötigen.
- Reddit Posts API — Öffentliche Beitragstexte, Autoren, Community-Kontext, Medien, Zeitstempel und sichtbare Interaktionen aus unterstützten Reddit-URLs erfassen.
- Reddit Subreddit Posts API — Öffentliche Beiträge aus Subreddit-URLs mit Sortierung nach „new“, „top“ oder „hot“, einem Ergebnislimit pro Subreddit und normalisiertem Community- und Interaktionskontext ermitteln.
- Reddit Subreddit Search API
- Reddit User Profile API — Reddit-Konten per Benutzername nachschlagen – mit Gesamt-, Post- und Kommentar-Karma, Aktivitätszahlen, Kontoalter und Profilmerkmalen.
- Reddit User Active Subreddits API — Die Subreddits, in denen ein Reddit-Nutzer aktiv ist, über einen Benutzernamen auflisten – mit Mitgliederzahlen und Beschreibungen.
- Reddit Subreddit Rules API — Die nummerierten Regeln von Subreddits über ihre URLs abrufen, mit Kurztitel und vollständigem Text jeder Regel.