Zurück zu den APIs
Öffentliche Reddit-Daten

Reddit Public Data API

Rufen Sie öffentliche Reddit-Beiträge und -Kommentare aus bekannten URLs ab, durchsuchen Sie neue, beliebte oder aktuell angesagte Subreddit-Beiträge oder suchen Sie Diskussionen per Stichwort und Veröffentlichungszeitraum.

Verfügbare Reddit-APIs

Verwenden Sie Posts für einen bekannten Beitrag, Comments für dessen öffentliche Antworten, Subreddit Posts für den Feed einer Community oder Search für die stichwortbasierte Suche.

Welche Reddit-Daten können Sie abrufen?

SocQ liefert normalisierte öffentliche Reddit-Inhalte mit Kontext zu Community, Antworten, Suche, Engagement und Erfassungszeitpunkt für die Analyse von Diskussionen.

Beiträge und sichtbares Engagement

Ruft Titel, Beitragstext, Autoren, Flairs, Community-Kontext, Medien, Quell-URLs und sichtbare Kennzahlen ab, die an collected_at gebunden sind.

Kommentare und Antwortbeziehungen

Ruft öffentliche Kommentartexte, Autoren, Verweise auf den Quellbeitrag und den übergeordneten Kommentar, Zeitstempel, Upvotes und Anzahl der Antworten ab.

Subreddit-Suche

Durchsucht neue, beliebte oder aktuell angesagte Beiträge aus /r/{subreddit}-URLs mit einem eigenen Ergebnislimit pro Community.

Stichwortsuche

Sucht öffentliche Beiträge per Textabfrage und Veröffentlichungszeitraum und hält den gefundenen Beitrag und den Suchkontext zusammen.

SocQ vs Reddit Data API

SocQ bietet Abläufe zur Erfassung öffentlicher Reddit-Daten. Die Data API von Reddit ist die offizielle Schnittstelle für genehmigte Apps, die auf Reddit-Daten zugreifen oder sie ändern.

FunktionSocQReddit Data API
HauptzweckÖffentliche Beiträge, Kommentare, Subreddit-Listen und Suchergebnisse erfassenGenehmigte Reddit-Apps, Integrationen und Moderationswerkzeuge entwickeln
AuthentifizierungSocQ-API-Schlüssel; kein Reddit-Nutzer-OAuthGenehmigung durch Reddit, OAuth-Zugangsdaten und eine deklarierte App-Identität
AusgangseingabeÖffentliche Beitrags- oder Subreddit-URL oder eine TextabfrageReddit-Endpunkte, Fullnames, Listing-Parameter und OAuth-Scopes
Beitragen, abstimmen oder moderierenNicht unterstütztUnterstützt für genehmigte Anwendungsfälle mit den erforderlichen Nutzer-Scopes
AntwortformatNormalisierte SocQ-DatensätzeNative Reddit-Objekte und Listings

So funktioniert die Reddit API

Direkte Erfassung, das Durchsuchen von Subreddits und die Stichwortsuche nutzen denselben asynchronen Aufgabenablauf mit paginierten Ergebnissen.

  1. 1. Eingabe senden

    Senden Sie Beitrags-URLs, Subreddit-URLs oder eine Suchabfrage an die passende API und speichern Sie die zurückgegebene task_id.

  2. 2. Aufgabe verfolgen

    Fragen Sie /v1/tasks/{task_id} ab, bis die Verarbeitung abgeschlossen ist.

  3. 3. Ergebnisse abrufen

    Lesen Sie data.results.items und verwenden Sie next_cursor, solange has_more den Wert true hat.

Öffentliche Reddit-Diskussionen suchen

Authentifizieren Sie sich mit Ihrem SocQ-API-Schlüssel und senden Sie ein Stichwort mit einem Veröffentlichungszeitraum. Die übrigen Reddit-APIs folgen demselben Aufgabenablauf.

curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"machine learning","results_limit":100,"published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Typische Anwendungsfälle der Reddit API

Community-Beobachtung

Erfassen Sie neue, beliebte oder aktuell angesagte Beiträge ausgewählter Subreddits und vergleichen Sie die sichtbare Aktivität zwischen Communities.

Analyse von Diskussionen und Reaktionen

Untersuchen Sie in ausgewählten Diskussionen Beitragsinhalt, Kommentartexte, Antwortbeziehungen, Autoren und das Engagement zum Zeitpunkt der Erfassung.

Themen- und Marktforschung

Suchen Sie definierte Stichwörter und Zeiträume, um öffentliche Diskussionen zu Produkten, Marken, Wettbewerbern oder Trends zu finden.

Recherchearchive und Datensätze

Bewahren Sie öffentliche Beiträge, Kommentare, Quelllinks, Community-Kontext, Zeitstempel und sichtbare Kennzahlen für wiederholbare Analysen auf.

Grenzen und Richtlinie für öffentliche Daten

Reddit-Ergebnisse sind öffentliche Datensätze zu einem bestimmten Zeitpunkt. Diese APIs greifen weder auf private Communities, gelöschte Inhalte und Kontodaten noch auf Moderationsfunktionen zu.

  • Posts und Comments akzeptieren unterstützte Beitrags-URLs oder redd.it-Links. Subreddit Posts erfordert einen genauen /r/{subreddit}-Pfad.
  • Subreddit Posts unterstützt die Sortierung nach neu, beliebt oder aktuell angesagt, wobei results_limit für jede Subreddit-URL separat gilt.
  • Search akzeptiert eine Abfrage, ein results_limit von 1 bis 2.000 und einen Veröffentlichungszeitraum von einer Stunde, einem Tag, einer Woche, einem Monat, einem Jahr oder allen Zeiten. Filter für Subreddit oder Sortierung werden nicht angeboten.
  • Posts und Comments bleiben getrennte Ressourcen; ein Beitrag enthält comments_count, aber keine einzelnen Kommentardatensätze.
  • Comments liefert sichtbare öffentliche Kommentare, garantiert aber weder einen vollständigen Antwortbaum noch die volle historische Tiefe einer Diskussion.
  • Sichtbare Kennzahlen sind Momentaufnahmen, die an collected_at gebunden sind. Optionale Felder können null oder leer sein, wenn die öffentliche Quelle sie nicht bereitstellt.

Häufige Fragen zur Reddit API

Was ist die Reddit API?

Die Reddit API ist eine Gruppe von SocQ-Endpunkten, mit denen Sie bekannte öffentliche Beiträge und Kommentare abrufen, Subreddit-Beiträge durchsuchen und öffentliche Diskussionen per Stichwort und Veröffentlichungszeitraum suchen.

Welche Reddit-Links werden akzeptiert?

Posts und Comments akzeptieren unterstützte Pfade im Format /r/{subreddit}/comments/{post_id} oder redd.it-Links. Subreddit Posts akzeptiert einen genauen /r/{subreddit}-Pfad.

Welche Reddit-API sollte ich wählen?

Verwenden Sie Posts für einen bekannten Beitrag, Comments für dessen öffentliche Antworten, Subreddit Posts für die Liste einer Community und Search für die stichwortbasierte Suche.

Wie unterscheiden sich das Durchsuchen von Subreddits und die Reddit-Suche?

Subreddit Posts durchsucht neue, beliebte oder aktuell angesagte Beiträge aus genauen /r/{subreddit}-URLs. Search findet öffentliche Beiträge anhand einer Textabfrage und eines Veröffentlichungszeitraums.

Sind Reddit-Kommentare und Engagement-Kennzahlen vollständig oder in Echtzeit?

Nein. Comments spiegelt die sichtbaren öffentlichen Antworten wider, die zum Zeitpunkt der Erfassung zurückgegeben wurden, und Engagement-Werte sind Momentaufnahmen und keine vollständige Historie und keine Echtzeit-Feeds.

Wie wird die Erfassung bei Reddit abgerechnet?

Jedes Ergebnis von Posts oder Subreddit Posts kostet 0,5 Credits, jeder Kommentar 0,3 Credits und jedes Search-Ergebnis 0,6 Credits; für eine leere Ergebnismenge fällt keine Ergebnisgebühr an.

Führen Sie öffentliche Profile, Inhalte und Interaktionsdaten verschiedener Plattformen in einem Workflow zusammen, um Marken, Creator und Themen zu verfolgen und plattformübergreifend effizienter zu überwachen und zu analysieren.