reddit/
subreddit-posts

Öffentliche Reddit-Beiträge aus Subreddit-URLs nach new, top oder hot sortiert finden – mit Inhalt, Autoren, Community-Kontext, Medien und sichtbarer Interaktion als normalisierte Datensätze.

Reddit Subreddit Posts API

Eingabe per Subreddit-URL
New, top oder hot
Limit pro Subreddit
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 Subreddit Posts

Beiträge in Subreddits sind öffentliche Einreichungen einer Community mit Titeln, Text, Autoren, Flair, Medien, Veröffentlichungszeiten und sichtbaren Signalen zu Stimmen und Kommentaren. Diese Felder zu Inhalt, Kontext und Interaktion unterstützen das Community-Monitoring, die Themenrecherche und abgestimmte Vergleiche über Subreddit-Listen hinweg.

Funktionen der Reddit Subreddit Posts API

  • Entdeckung über Subreddit-ListenFinden Sie öffentliche Beiträge aus akzeptierten /r/{subreddit}-URLs und wählen Sie die Liste new, top oder hot für jedes Subreddit der Anfrage.
  • Erfassungstiefe pro SubredditWenden Sie results_limit separat auf jede gesendete Subreddit-URL an, mit dem Standardwert 100 und einem zulässigen Bereich von 1 bis 2.000.
  • Normalisierte Beitragsinhalte und AutorenLiefert Beitragskennungen, Quell-URLs, Titel, Text, verfügbare Autorenfelder und Medienverweise in einer einheitlichen Datensatzform.
  • Community- und InteraktionskontextBehält Flair, Community-Details, Veröffentlichungs- und Erfassungszeit, upvotes_count, comments_count, upvote_ratio und discovery_input bei jedem Beitrag bei.

Parameter der Reddit Subreddit Posts API

ParameterErforderlichBeschreibung
urlsErforderlichErforderliche Liste öffentlicher Reddit-Subreddit-URLs mit genau dem Pfad /r/{subreddit} auf einem unterstützten Reddit-Host.
results_limitOptionalMaximale Anzahl der angeforderten Beiträge pro Subreddit-URL; der Standardwert ist 100, akzeptiert werden ganze Zahlen von 1 bis 2.000.
sort_byOptionalListe, die auf jede gesendete Subreddit-URL angewendet wird; der Standardwert ist new, unterstützt werden new, top oder hot.

So verwenden Sie die Reddit Subreddit Posts API

Senden Sie öffentliche Subreddit-URLs mit einem Listenmodus und einem Ergebnislimit pro Subreddit und lesen Sie die Ergebnisse der asynchronen Aufgabe per Cursor-Paginierung aus.

  1. Bereiten Sie eine oder mehrere öffentliche Reddit-URLs vor, deren Pfad /r/{subreddit} lautet.
  2. Senden Sie urls, results_limit und sort_by per POST an /v1/reddit/subreddit-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 den zurückgegebenen next_cursor an, solange has_more den Wert true hat.
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/"],"results_limit":100,"sort_by":"new"}'

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

Anwendungsfälle der Reddit Subreddit Posts API

  • Monitoring von Community-Beiträgen: Erfassen Sie die Liste new und behalten Sie Beitrags-IDs, created_at, collected_at, Titel und Text bei, um aktuelle öffentliche Einreichungen in ausgewählten Subreddits zu prüfen.
  • Themenrecherche in Subreddits: Gruppieren Sie Titel, Text, Flair und Community-Felder, um wiederkehrende Themen und Formate in definierten öffentlichen Communities zu untersuchen.
  • Abgestimmter Vergleich von Listen: Verwenden Sie dasselbe sort_by für alle Subreddit-URLs und vergleichen Sie Veröffentlichungszeiten, upvotes_count, comments_count und upvote_ratio unter einem Listenmodus.

Profi-Tipps zur Reddit Subreddit Posts API

  • Senden Sie die kanonische Startseiten-URL /r/{subreddit} statt eines Subreddit-Namens, einer Beitrags-URL oder eines tieferen Pfads, damit die Anfrage die URL-Prüfung besteht.
  • Berechnen Sie die angeforderte Tiefe als Anzahl der urls multipliziert mit results_limit, denn Limit und Credit-Schätzung gelten separat für jedes Subreddit.
  • Führen Sie getrennte Aufgaben aus, wenn Sie new, top und hot vergleichen, denn ein sort_by-Wert wird auf jede Subreddit-URL einer Anfrage angewendet.
  • Behalten Sie discovery_input und collected_at bei jedem Datensatz bei, damit nachgelagerte Datensätze das Quell-Subreddit und den Beobachtungszeitpunkt bewahren.
  • Erlauben Sie für Autor, Medien, Flair, Community, Zeitstempel und Interaktion den Wert null oder leer, wenn eine öffentliche Liste sie nicht bereitstellt.

Ergänzend zur Reddit Subreddit Posts 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 Comments API — Öffentliche Kommentartexte, Autoren, Verweise auf Beitrag und übergeordneten Kommentar, Community-Kontext, Zeitstempel und sichtbare Interaktionen aus unterstützten Beitrags-URLs erfassen.
  • 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 Subreddit Posts API — FAQ

Reddit Subreddit Posts API findet öffentliche Beiträge aus akzeptierten Subreddit-URLs mit der Sortierung new, top oder hot. Die Schnittstelle liefert normalisierte Inhalte, Autoren, Community-Kontext, Medien, Zeitstempel und sichtbare Interaktion.

Senden Sie eine http- oder https-URL auf einem unterstützten Reddit-Host, deren Pfad genau /r/{subreddit} lautet, optional mit abschließendem Schrägstrich. Subreddit-Namen, Beitrags-URLs und tiefere Pfade werden nicht akzeptiert.

sort_by unterstützt new, top und hot; der Standardwert ist new. Die Anfrage akzeptiert für top-Listen keinen Parameter für ein Zeitfenster.

results_limit hat den Standardwert 100 und akzeptiert Werte von 1 bis 2.000. Es gilt separat für jede URL, sodass zwei URLs mit results_limit 50 bis zu 100 Beiträge anfordern.

Nein. Jeder Beitrag kann comments_count enthalten, aber das Ergebnis enthält weder Kommentartexte noch Kommentarautoren.

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

Jeder zurückgegebene Beitragsdatensatz kostet 0,5 SocQ-Credits. Die Schätzung vor der Anfrage verwendet urls multipliziert mit results_limit, und für eine leere Ergebnismenge fällt keine Ergebnisgebühr an.