Der richtige Weg, Reddit zu integrieren, hängt davon ab, was Ihr Produkt tatsächlich tut. Ein Moderations-Bot, der in einer Community installiert ist, ein nicht kommerzieller OAuth-Client, eine wissenschaftliche Studie und ein kommerzielles Social-Listening-Produkt haben weder denselben Zugangsweg noch dieselben Pflichten.
Dieser Leitfaden erklärt die aktuellen offiziellen Reddit-Optionen und zeigt, wie Sie über SocQ öffentliche Beiträge, Kommentare, Subreddit-Feeds, Subreddit-Metadaten und Suchergebnisse abrufen, wenn Ihre Anwendung einen verwalteten, rein lesenden Datenendpunkt braucht.
Kurze Antwort: Nutzen Sie die offizielle Developer Platform von Reddit für Apps, die auf Reddit laufen, und beantragen Sie die offizielle Data API, wenn Ihr Anwendungsfall zu deren Richtlinien passt. Nutzen Sie SocQ, wenn Sie einen API-Schlüssel und normalisierte öffentliche Reddit-Datensätze zusammen mit anderen Social-Media-Plattformen brauchen. Keiner der beiden Wege erlaubt es, die Bedingungen von Reddit, die Pflichten zum Löschen von Inhalten, Datenschutzrechte oder Beschränkungen für das Training von Modellen zu ignorieren.
Zugangsvoraussetzungen und Richtlinien wurden am 19. Juli 2026 geprüft. Reddit kann Genehmigungsregeln und Limits ändern. Prüfen Sie deshalb vor dem Start die verlinkte offizielle Dokumentation.
Welche Reddit API sollten Sie nutzen?
Reddit beschreibt inzwischen mehrere voneinander getrennte Entwicklerschnittstellen:
| Produkt | Ausgelegt für | Wichtige Grenze |
|---|---|---|
| Developer Platform (Devvit) | Spiele, Hilfsprogramme und Moderations-Apps, die auf Reddit laufen | Die App ist für das Reddit-Erlebnis gebaut |
| Data API | Genehmigter programmatischer Zugriff zum Lesen oder Ändern von Reddit-Daten | OAuth, Prüfung, Richtlinien und Ratenbegrenzungen gelten |
| Reddit for Researchers | Berechtigte wissenschaftliche Forschung | Offizieller Weg für Forschung; Antrag erforderlich |
| Ads API | Werbetreibende, die Kampagnen und Reporting verwalten | Werbe-Workflows, keine allgemeinen Community-Daten |
| Reddit Embeds | Darstellung einzelner Reddit-Inhalte | Präsentation statt Zugriff auf Massendaten |
| Verwaltete API für öffentliche Daten | Produkt-Workflows, die öffentliche Datensätze in einem stabilen Schema brauchen | Abdeckung und Bedingungen des Anbieters gelten weiterhin |
Laut der Übersicht von Reddit zum Entwicklerzugang ist die Data API für genehmigte Entwickler gedacht, und wissenschaftliche Forschung muss Reddit for Researchers nutzen. Die kommerzielle Nutzung erfordert die Erlaubnis von Reddit und einen Vertrag.
Das bedeutet: Die Entscheidung für eine API sollte mit der Einordnung des Anwendungsfalls beginnen, nicht mit einer Code-Bibliothek.
Anforderungen der offiziellen Reddit Data API 2026
Für die berechtigte kostenlose Nutzung der Data API verlangt Reddit derzeit ein registriertes OAuth-Token und einen aussagekräftigen User-Agent. Nicht authentifizierter Traffic kann blockiert werden, statt das Standardkontingent zu erhalten.
Das offizielle Data API Wiki von Reddit nennt ein Limit von 100 Abfragen pro Minute je OAuth-Client-ID, gemittelt über ein Zehn-Minuten-Fenster. Clients sollten Folgendes auswerten:
X-Ratelimit-UsedX-Ratelimit-RemainingX-Ratelimit-Reset
Betrachten Sie 100 QPM nicht als allgemeine kommerzielle Stufe. Es ist das veröffentlichte Limit für Nutzer, die zum kostenlosen Zugang berechtigt sind. Reddit erklärt, dass die kommerzielle Nutzung – einschließlich bezahlter Produkte, werbefinanzierter Produkte, Abonnementdienste und gegen Gebühr verkaufter Dienste – eine vorherige Erlaubnis erfordert. Umfassenderer oder bezahlter Zugang wird gesondert behandelt und nicht über eine öffentliche Preistabelle zum Selbstbedienen abgewickelt.
Reddit verlangt außerdem den Umgang mit Löschungen. Die aktuelle Richtlinie besagt, dass gespeicherte Inhalte, die bei Reddit gelöscht wurden, auch aus Ihren Systemen gelöscht werden müssen und dass identifizierende Angaben zum Autor, die einem gelöschten Konto zugeordnet sind, entfernt werden müssen. Die Dokumentation empfiehlt, gespeicherte Nutzerdaten und Inhalte regelmäßig innerhalb von 48 Stunden zu löschen, um die Einhaltung zu erleichtern.
Beispiel für die Authentifizierung bei der offiziellen API
Eine installierte oder Script-Anwendung tauscht in der Regel ihre Client-Zugangsdaten und die Autorisierung des Nutzers gegen ein OAuth-Token ein und sendet dieses Token dann an oauth.reddit.com.
Die vereinfachte Form der Anfrage sieht so aus:
curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
-H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
-H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"
Produktive Clients müssen:
- Den passenden Anwendungsfall registrieren und genehmigen lassen.
- Den zutreffenden OAuth-Grant implementieren.
- Ablaufende Tokens erneuern, wo dies unterstützt wird.
- Einen wahrheitsgemäßen, eindeutigen User-Agent senden.
- Die Header zur Ratenbegrenzung beachten und die Last drosseln, bevor das Limit erschöpft ist.
- Löschungen und Richtlinienänderungen verarbeiten.
Python-Entwickler nutzen häufig PRAW, um Listing-Objekte, Paginierung und OAuth-Details abzudecken. Direktes HTTP kann angemessen sein, wenn Sie weniger Abhängigkeiten wollen, es hebt aber keine Pflicht aus den Richtlinien auf.
Einen Reddit-Beitrag per URL mit SocQ abrufen
Die Reddit Posts API von SocQ akzeptiert öffentliche Reddit-Beitrags-URLs und redd.it-Kurzlinks. Sie liefert normalisiert Titel, Text, Autor, Community-Kontext, Zeitstempel, öffentliche Medienverweise und sichtbare Interaktion.
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
Die Anfrage erzeugt eine asynchrone Aufgabe. Speichern Sie die zurückgegebene task_id und fragen Sie dann den Status ab:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Wenn die Aufgabe erfolgreich abgeschlossen ist, liegen die Datensätze in data.results.items. Fahren Sie mit next_cursor fort, solange has_more den Wert true hat.
Ein Beitragsdatensatz hat dieselbe grobe Struktur wie andere SocQ-Ressourcen:
{
"id": "post_id",
"platform": "reddit",
"resource": "posts",
"type": "post",
"url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
"name": "Example post title",
"text": "Example post body",
"author": {
"username": "example_user",
"name": "example_user"
},
"metrics": {
"upvotes_count": 842,
"comments_count": 54,
"upvote_ratio": 0.96
},
"created_at": "2026-07-16T08:00:00Z",
"collected_at": "2026-07-19T08:00:00Z",
"extra": {
"tag": "Discussion",
"community_name": "learnpython"
}
}
Sichtbare Scores sind Momentaufnahmen und keine dauerhafte Wahrheit. Reddit kann Stimmenzahlen verfälschen, Inhalte können bearbeitet oder entfernt werden, und eine spätere Erfassung kann abweichen.
Reddit-Kommentare abrufen
Nutzen Sie die Reddit Comments API, wenn Sie die öffentliche Diskussion unter bekannten Beitrags-URLs brauchen:
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
Normalisierte Kommentardatensätze enthalten:
- Kommentar-ID, URL und Text.
- Öffentliche Autorenfelder, sofern verfügbar.
- Sichtbare Upvote- und Antwortzahlen.
- Verweise auf Quellbeitrag und Community.
- ID des übergeordneten Kommentars, sofern verfügbar.
- Zeitstempel für Veröffentlichung und Erfassung.
Der aktuelle SocQ-Endpunkt akzeptiert keine Eingabe results_limit. Gehen Sie nicht davon aus, dass jeder sichtbare Zweig, jede eingeklappte Antwort, jeder gelöschte Kommentar, jedes Element nur für Moderatoren und jedes dynamisch gerankte Ergebnis zurückgegeben wird. Wenn die vollständige Rekonstruktion eines Threads eine harte Anforderung ist, testen Sie repräsentative tiefe und große Threads, bevor Sie sich für einen Anbieter entscheiden.
Neue, Top- oder Hot-Beiträge eines Subreddits abrufen
Für das Community-Monitoring akzeptiert die Reddit Subreddit Posts API eine oder mehrere öffentliche Subreddit-URLs. sort_by unterstützt new, top und hot; results_limit akzeptiert 1 bis 2.000 je übermitteltem Subreddit.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/",
"https://www.reddit.com/r/webdev/"
],
"sort_by": "new",
"results_limit": 250
}'
Wählen Sie die Sortierung bewusst:
| Sortierung | Geeignet für | Einschränkung |
|---|---|---|
new | Inkrementelles Monitoring und Benachrichtigungen | Enthält mehr Beiträge mit wenig Signal |
hot | Aktuelle Aufmerksamkeit in der Community | Das Ranking ändert sich laufend |
top | Entdeckung von Inhalten mit hoher Interaktion | Kann ältere oder bereits beliebte Inhalte überrepräsentieren |
Erfassen Sie für das Monitoring new nach Zeitplan und entfernen Sie Duplikate anhand der Beitrags-ID. Nutzen Sie hot oder top als separate Sicht zur Entdeckung, statt den chronologischen Feed zu überschreiben.
Reddit-Beiträge per Keyword suchen
Die Reddit Search API akzeptiert eine Suchanfrage, ein Ergebnislimit von 1 bis 2.000 und ein Veröffentlichungsfenster:
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "\"social listening\" API",
"results_limit": 500,
"published_within": "month"
}'
Unterstützte Fenster sind hour, day, week, month, year und all.
Suchergebnisse sind gerankte Ergebnisse der Entdeckung, kein garantiert vollständiges Archiv. Syntax der Anfrage, Ranking, Verfügbarkeit und Indexierung können die Abdeckung beeinflussen. Führen Sie mehrere enge Suchanfragen aus, statt von einer einzigen breiten Anfrage zu erwarten, dass sie die gesamte Unterhaltung abbildet.
Für das Markenmonitoring verwenden Sie zum Beispiel eine Gruppe von Suchanfragen:
"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative
Speichern Sie die Suchanfrage im Kontext der Entdeckung, damit Analysten erklären können, warum jeder Datensatz in den Datenbestand gelangt ist.
Subreddit-Details und Suche innerhalb eines Subreddits
Zwei weitere Endpunkte decken die Community selbst ab. Die Reddit Subreddit Details API nimmt öffentliche Subreddit-URLs entgegen und liefert Metadaten wie Abonnentenzahlen, wöchentlich aktive Nutzer, Regeln und Community-Assets. So lässt sich eine Community günstig einschätzen, bevor Sie sie überwachen.
Die Reddit Subreddit Search API durchsucht öffentliche Diskussionen und Beiträge innerhalb eines bestimmten Subreddits nach Suchanfrage, Zeitraum und Sortierung. Nutzen Sie sie, wenn ein Markenbegriff nur in wenigen Communities relevant ist und eine Reddit-weite Suche ihn untergehen ließe. Die genauen Eingabefelder finden Sie auf der Seite des jeweiligen Endpunkts.
Eine zuverlässige Pipeline für das Reddit-Monitoring aufbauen
Ein dauerhafter Workflow trennt Erfassung, Speicherung und Analyse:
Query/subreddit registry
↓
Scheduled SocQ submissions
↓
Task polling with backoff
↓
Normalize + deduplicate by Reddit ID
↓
Deletion/retention controls
↓
Classification, alerts and reporting
Empfohlene Regeln für die Umsetzung:
- Stabile IDs verwenden. URLs und Slugs können sich ändern; Reddit-IDs sind bessere Schlüssel für die Deduplizierung.
- Quellkontext behalten. Speichern Sie Subreddit, Suchanfrage, Sortierung und Erfassungszeit.
- Momentaufnahmen von Entitäten trennen. Kennzahlen ändern sich, während die Beitrags-ID stabil bleibt.
- Aufgaben wiederholen, nicht einzelne Datensätze. Exponentielles Backoff vermeidet doppelte Übermittlungen.
- Zustände „fehlend“ und „gelöscht“ festhalten. Machen Sie aus einem Fehlen keinen leeren, aber gültigen Beitrag.
- Personenbezogene Daten minimieren. Die meisten Analysen brauchen keine langfristigen Verläufe auf Autorenebene.
- Einen Weg zur Löschung vorsehen. Ihr Datenmodell sollte Inhalte und Verweise auf Autoren entfernen können.
Offizielle Reddit API im Vergleich zu SocQ
| Anforderung | Offizielle Reddit API | SocQ |
|---|---|---|
| Eine App oder ein Moderations-Tool auf Reddit bauen | Beste Wahl | Nicht unterstützt |
| Lesende und schreibende Aktionen auf Reddit | Unterstützt, vorbehaltlich Genehmigung und Scopes | Nur Lesen öffentlicher Daten |
| OAuth und Registrierung der Reddit-App | Erforderlich | SocQ-API-Schlüssel |
| Normalisierung öffentlicher Beiträge und Kommentare | Reddit-native Objekte | Gemeinsames SocQ-Schema |
| Social-Media-Produkt über mehrere Plattformen | Getrennte Integrationen | Dasselbe Aufgabenmodell über 27 Plattformen |
| Veröffentlichte kostenlose Ratenbegrenzung | 100 QPM für berechtigte OAuth-Clients | Endpunktpreise im SocQ-Katalog |
| Kommerzielle Erlaubnis | Erlaubnis oder Vertrag von Reddit erforderlich | Der Zugang über den Anbieter hebt die Regeln von Reddit nicht auf |
| Wissenschaftliche Forschung | Reddit for Researchers erforderlich | Nicht als Umgehung der Richtlinien nutzen |
Wählen Sie den offiziellen Weg, wenn Ihr Produkt vom Nutzer autorisierte Aktionen, Moderation, Posten, Abstimmen, Nachrichten oder tiefe Reddit-native Integrationen ausführt. Wählen Sie SocQ für die unterstützte Erfassung öffentlicher Daten, wenn normalisierte Multi-Plattform-Datensätze und verwaltete Extraktion wichtiger sind als Schreibzugriff.
Workload und Kosten schätzen
Vergleichen Sie Anbieter nicht nur nach „Anfragen“. Eine Anfrage kann einen Beitrag liefern, eine Seite mit Kommentaren oder Hunderte Subreddit-Ergebnisse.
Schätzen Sie:
monthly records =
direct post lookups
+ comments returned
+ subreddit posts returned
+ search results returned
monthly workload =
schedules × inputs per run × average records per input
Berücksichtigen Sie dann:
- Leere oder nicht verfügbare Ergebnisse.
- Aktualisierungshäufigkeit.
- Überschneidungen bei der Suche und Deduplizierung.
- Tiefe Kommentar-Threads.
- Speicherung und Verarbeitung von Löschungen.
- Anforderungen an Parallelität und Latenz.
- Ob nur erfolgreiche Ergebnisse abgerechnet werden.
Führen Sie einen repräsentativen Pilotbetrieb über kleine und große Communities durch, bevor Sie die jährlichen Ausgaben hochrechnen.
Verantwortungsvolle Nutzung und Datenaufbewahrung
Öffentliche Verfügbarkeit ist keine pauschale Erlaubnis für jede Nutzung. Die aktuellen Richtlinien von Reddit beschränken den kommerziellen Zugang ohne Genehmigung und untersagen die Nutzung von Reddit-Inhalten für das Training von Modellen ohne ausdrückliche Zustimmung. Außerdem legen sie Pflichten zur Löschung fest.
Richten Sie die folgenden Kontrollen ein, bevor Sie skalieren:
- Erfassen Sie nur Felder, die für den erklärten Zweck nötig sind.
- Vermeiden Sie Profiling sensibler Personen und die Belästigung Einzelner.
- Nutzen Sie die API nicht, um Beschränkungen von Subreddits oder Konten zu umgehen.
- Bewahren Sie die Quellenangabe, wo Inhalte angezeigt werden.
- Legen Sie kurze Aufbewahrungsfristen für Rohinhalte fest.
- Prüfen Sie Inhalte, die nicht mehr verfügbar sind, erneut oder entfernen Sie sie.
- Schützen Sie API-Schlüssel und prüfen Sie den Zugriff auf Exporte.
- Holen Sie für kommerzielle, wissenschaftliche oder risikoreiche Nutzung eine rechtliche Prüfung ein.
SocQ ist eine technische Zugriffsschicht und gewährt keine Rechte an geistigem Eigentum, keine Datenschutz-, Forschungs- oder kommerziellen Rechte.
Häufig gestellte Fragen zur Reddit API (FAQ)
Ist die Reddit API kostenlos?
Reddit bietet je nach Anwendungsfall kostenlosen und bezahlten Zugang. Berechtigte Clients der kostenlosen Data API haben derzeit ein veröffentlichtes Limit von 100 QPM je OAuth-Client-ID. Die kommerzielle Nutzung erfordert die Erlaubnis von Reddit und kann einen Vertrag sowie Gebühren erfordern.
Kann ich die Reddit API ohne OAuth nutzen?
Planen Sie nicht mit nicht authentifiziertem Zugriff. Die aktuelle Dokumentation von Reddit verlangt registrierte OAuth-Tokens und besagt, dass Traffic ohne OAuth- oder Login-Zugangsdaten blockiert wird.
Darf ich Reddit für KI-Training scrapen?
Reddit erklärt, dass seine Inhalte ohne ausdrückliche Zustimmung nicht als Eingabe für das Training von Modellen verwendet werden dürfen. Eine API von Drittanbietern hebt diese Beschränkung nicht auf.
Unterstützt SocQ Reddit-Kommentare?
Ja. SocQ hat sechs Reddit-Endpunkte: direkte Beiträge, Kommentare aus Beitrags-URLs, Entdeckung von Subreddit-Beiträgen, Subreddit-Details, Keyword-Suche über ganz Reddit und Suche innerhalb eines einzelnen Subreddits.
Kann SocQ auf Reddit posten, abstimmen oder moderieren?
Nein. Die Reddit-Endpunkte von SocQ erfassen unterstützte öffentliche Datensätze. Nutzen Sie für autorisierte Schreibaktionen und Moderation die offiziellen Entwicklerprodukte von Reddit.
Sind Reddit-Suchergebnisse vollständig?
Nein. Behandeln Sie die Suche als gerankte Entdeckung. Die Ergebnisse hängen von Suchanfrage, Zeitfenster, Indexierung und Verfügbarkeit ab; sie sind kein vollständiges historisches Archiv.
Was passiert, wenn ein Reddit-Nutzer Inhalte löscht?
Ihr System sollte den Inhalt und zugehörige identifizierende Angaben zum Autor entfernen können. Die offizielle Richtlinie von Reddit empfiehlt, gespeicherte Nutzerdaten und Inhalte regelmäßig innerhalb von 48 Stunden zu löschen, um die Einhaltung zu vereinfachen.
REDDIT API
Workflow mit einer öffentlichen Reddit-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
Reddit-APIs ansehen