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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche 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.
- Bereiten Sie eine oder mehrere öffentliche Reddit-Beitrags-URLs mit einem unterstützten comments-Pfad oder redd.it-Kurzlinks vor.
- Senden Sie die Links als urls an /v1/reddit/posts und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich ist oder einen Fehler meldet.
- 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 trueAnwendungsfä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.
Verwandte APIs
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.