reddit/
posts

Öffentliche Reddit-Beiträge aus unterstützten Beitrags-URLs erfassen – mit Titeln, Text, Autoren, Community-Kontext, Medien, Zeitstempeln und sichtbarer Interaktion in normalisierten Datensätzen.

Reddit Posts API

Eingabe per Beitrags-URL
Community-Kontext
Momentaufnahme der Interaktion
0,5 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

Reddit Posts

Ein Reddit-Beitrag ist eine Einreichung in einer Community, deren öffentliche Seite Titel, Text, Autor, Flair, Medien, Veröffentlichungszeitpunkt sowie sichtbare Signale zu Stimmen und Kommentaren zeigen kann. Werden diese Felder mit dem Subreddit und dem Erfassungszeitpunkt verknüpft, lässt sich ein einzelner Beitrag für Quellenprüfung, Inhaltsanalyse und den Vergleich mit Zeitstempel nutzen.

Funktionen der Reddit Posts API

  • Direkte Auflösung von BeiträgenLöst die URL einer akzeptierten Reddit-Diskussion oder einen redd.it-Kurzlink in einen normalisierten Datensatz für diesen öffentlichen Beitrag auf und weist Startseiten von Subreddits und fremde Pfade zurück.
  • Beitragsinhalt und ZuordnungLiefert die Beitrags-ID, die öffentliche URL, den Titel, den Text und die verfügbaren Autorenkennungen, damit sich jeder Eintrag zu seiner Quelle zurückverfolgen lässt.
  • Subreddit- und KlassifizierungskontextStellt Flair sowie Namen, URL und sichtbare Mitgliederzahl der Community unter extra bereit, sofern die Quelle sie liefert.
  • Medien, Interaktion und ErfassungszeitpunktHält Medienverweise, created_at, collected_at, upvotes_count, comments_count und upvote_ratio in einer Momentaufnahme mit Zeitstempel zusammen.

Parameter der Reddit Posts API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche Liste öffentlicher Reddit-Beitrags-URLs mit Pfaden der Form /r/{subreddit}/comments/{post_id} auf unterstützten Reddit-Hosts oder redd.it-Kurzlinks.

So verwenden Sie die Reddit Posts API

Senden Sie genau die öffentlichen Beiträge, die Sie brauchen, verfolgen Sie die asynchrone Aufgabe und lesen Sie die normalisierten Datensätze per Cursor-Paginierung aus.

  1. Bereiten Sie eine oder mehrere öffentliche Reddit-Beitrags-URLs mit einem unterstützten comments-Pfad oder redd.it-Kurzlinks vor.
  2. Senden Sie die Links als urls an /v1/reddit/posts und speichern Sie die zurückgegebene task_id.
  3. Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
  4. Lesen Sie data.results.items und fordern Sie dann den zurückgegebenen next_cursor an, solange has_more den Wert true hat.
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/example/comments/post_id/example_post/"]}'

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

Anwendungsfälle der Reddit Posts API

  • Prüfung von Beiträgen mit Quellenbeleg: Behalten Sie Beitrags-IDs, URLs, Titel, Text und Autorenfelder bei, damit Prüfer die genauen öffentlichen Einreichungen einer Analyse jederzeit erneut aufrufen können.
  • Themenvergleich über Communities hinweg: Gruppieren Sie Titel und Text nach community_name und tag, um zu untersuchen, wie ein definiertes Thema in ausgewählten Subreddits dargestellt wird.
  • Verfolgung der Interaktion mit Zeitstempel: Speichern Sie upvotes_count, comments_count und upvote_ratio mit collected_at, um wiederholte Momentaufnahmen zu vergleichen, ohne die Werte als dauerhaft zu behandeln.

Profi-Tipps zur Reddit Posts API

  • Lösen Sie redd.it-Links auf und entfernen Sie Duplikate anhand der Beitragskennung, bevor Sie Stapel bilden, denn ein Kurzlink und eine vollständige Diskussions-URL können auf denselben Beitrag zeigen.
  • Verwenden Sie diesen Endpunkt, wenn Sie die Beitrags-URLs bereits kennen; er akzeptiert weder Startseiten von Subreddits noch Suchanfragen, Sortierung oder results_limit.
  • Erlauben Sie für Autor, Medien, tag, Community-Angaben, Zeitstempel und Kennzahlen den Wert null, wenn die öffentliche Quelle sie nicht bereitstellt.
  • Speichern Sie collected_at neben den sichtbaren Interaktionskennzahlen, damit sich spätere Momentaufnahmen vergleichen lassen, ohne ihre Beobachtungszeiten zu überschreiben.

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

  • Reddit Comments API — Öffentliche Kommentartexte, Autoren, Verweise auf Beitrag und übergeordneten Kommentar, Community-Kontext, Zeitstempel und sichtbare Interaktionen aus unterstützten Beitrags-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 Search API — Öffentliche Reddit-Beiträge per Textsuche und Veröffentlichungszeitraum suchen und normalisierte Inhalte, Autoren, Community-Kontext, Zeitstempel, Medien und sichtbare Interaktionen zurückgeben.
  • Reddit Subreddit Details API
  • Reddit User Posts API — Den Post-Verlauf eines Reddit-Nutzers über einen Benutzernamen sammeln, sortiert nach new, top oder hot, mit Titel und Text, Score, Kommentaren und Medien.
  • Reddit Popular Feed API — Posts aus r/popular in der Sortierung hot, best, new, rising oder top erfassen – mit Titel und Text, Autor, Score, Kommentaren und Medien.

Weitere Plattformen entdecken

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

Reddit Posts API — FAQ

Reddit Posts API löst unterstützte öffentliche Reddit-Beitrags-URLs in normalisierte Datensätze auf, die Beitragsinhalt, Autoren- und Subreddit-Kontext, Medien, Zeitstempel und sichtbare Interaktionskennzahlen enthalten.

Senden Sie eine http- oder https-URL auf reddit.com, www.reddit.com, old.reddit.com oder new.reddit.com, deren Pfad mit /r/{subreddit}/comments/{post_id} beginnt. Auch die Kurzlinks redd.it und www.redd.it werden akzeptiert.

Nein. Reddit Posts API löst die konkreten Beitrags-URLs in urls auf; Startseiten von Subreddits, Stichwörter oder Sortierung zum Auffinden von Beiträgen werden nicht akzeptiert.

Nein. Dieser Endpunkt akzeptiert nur urls, denn jede Eingabe bezeichnet einen bestimmten Beitrag und keinen Feed, den man begrenzen könnte.

Nein. Jeder Beitragsdatensatz kann ein sichtbares comments_count enthalten, aber keine Kommentartexte oder Kommentarautoren.

Autorendetails, Medien, Flair, Community-Kontext, Veröffentlichungszeitpunkt und Interaktionswerte können null oder leer sein, wenn die öffentliche Quelle keinen verwertbaren Wert bereitstellt.

Jeder zurückgegebene Beitragsdatensatz kostet 0,5 SocQ-Credits. Für eine leere Ergebnismenge fällt keine Ergebnisgebühr an.