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
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliche Liste öffentlicher Reddit-Subreddit-URLs mit genau dem Pfad /r/{subreddit} auf einem unterstützten Reddit-Host. |
results_limit | Optional | Maximale Anzahl der angeforderten Beiträge pro Subreddit-URL; der Standardwert ist 100, akzeptiert werden ganze Zahlen von 1 bis 2.000. |
sort_by | Optional | Liste, 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.
- Bereiten Sie eine oder mehrere öffentliche Reddit-URLs vor, deren Pfad /r/{subreddit} lautet.
- Senden Sie urls, results_limit und sort_by per POST an /v1/reddit/subreddit-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 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 trueAnwendungsfä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.
Verwandte APIs
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.