Reddit Search
Die Ergebnisse von Reddit Search sind öffentliche Beiträge, die zu einer Textabfrage passen, mit Titeln, Text, Autoren, Subreddit-Kontext, Medien, Veröffentlichungszeiten und sichtbaren Signalen zu Stimmen und Kommentaren. Diese Datensätze eignen sich für die Themenrecherche, die Quellenprüfung, die Untersuchung bestimmter Zeiträume und den Vergleich der Interaktion über definierte Abfragen hinweg.
Funktionen der Reddit Search API
- Beitragssuche per AbfrageNutzen Sie eine nicht leere Textabfrage, um öffentliche Reddit-Beiträge zu finden, ohne Beitrags- oder Subreddit-URLs anzugeben.
- Filter nach VeröffentlichungszeitraumBegrenzen Sie die Suche auf die letzte Stunde, den letzten Tag, die letzte Woche, den letzten Monat oder das letzte Jahr oder verwenden Sie all für den gesamten unterstützten Zeitraum.
- Begrenzte ErgebnisanfragenLegen Sie results_limit zwischen 1 und 2.000 fest, um die maximale Anzahl der für die Abfrage angeforderten Beiträge zu steuern.
- Normalisierter Beitrags- und SuchkontextLiefert Beitragsinhalt, Autoren- und Community-Felder, Medien, Zeitstempel, sichtbare Interaktion und die Sucheingabe in einem einheitlichen Datensatz.
Parameter der Reddit Search API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
query | Erforderlich | Erforderlicher, nicht leerer Text, mit dem öffentliche Reddit-Beiträge gefunden werden. |
results_limit | Optional | Maximale Anzahl der angeforderten Beiträge. Der Standardwert ist 100; akzeptiert werden ganze Zahlen von 1 bis 2.000. |
published_within | Optional | Veröffentlichungszeitraum der gefundenen Beiträge. Der Standardwert ist all; unterstützt werden hour, day, week, month, year oder all. |
So verwenden Sie die Reddit Search API
Senden Sie eine fokussierte Abfrage mit dem gewünschten Zeitraum und der Obergrenze für Ergebnisse und lesen Sie die normalisierten Beitragsdatensätze aus der abgeschlossenen asynchronen Aufgabe.
- Bereiten Sie eine nicht leere Textabfrage vor und wählen Sie optional ein Zeitfenster für published_within und ein results_limit.
- Senden Sie die Parameter per POST an /v1/reddit/search 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/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 trueAnwendungsfälle der Reddit Search API
- Entdeckung von Diskussionen zu einem Thema: Finden Sie mit Beitragstiteln, Text, Community-Namen und Quell-URLs öffentliche Diskussionen, die zu einem definierten Thema passen.
- Recherche-Datensätze mit Quellenbezug: Bewahren Sie Beitrags-IDs, URLs, Autoren, Veröffentlichungszeiten und discovery_input auf, damit jeder erfasste Datensatz mit seiner Quelle und seiner Abfrage verbunden bleibt.
- Vergleich der Interaktion nach Zeitfenster: Kombinieren Sie published_within mit created_at, collected_at, upvotes_count, comments_count und upvote_ratio, um begrenzte Ergebnisstichproben zu vergleichen.
Profi-Tipps zur Reddit Search API
- Verwenden Sie eine fokussierte Abfrage, die genau eine Forschungsfrage abbildet, damit Beitragstexte und Community-Kontext der Treffer deutbar bleiben.
- Wählen Sie published_within passend zum gewünschten Zeitraum; belassen Sie es bei all, wenn eine zeitliche Grenze relevante ältere Beiträge ausschließen würde.
- Behandeln Sie results_limit als Obergrenze der Anfrage und folgen Sie den Cursorn der Aufgabenergebnisse, bis has_more den Wert false hat, um alle gespeicherten Ergebnisse zu lesen.
- Entfernen Sie Duplikate wiederholter Suchen anhand der Beitrags-ID und behalten Sie extra.discovery_input und collected_at für den Kontext von Abfrage und Beobachtung bei.
- Behandeln Sie Felder zu Autor, Medien, Community, Zeitstempel und Interaktion als nullable, denn die öffentliche Quelle kann einzelne Werte auslassen.
Verwandte APIs
Ergänzend zur Reddit Search 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 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 Subreddit Search API
- Reddit Trending Searches API — Die heutigen Trend-Suchen auf Reddit ohne Eingabe abrufen, jeweils mit Rang und Link zu den Reddit-Ergebnissen.
- Reddit Answers API — Eine Frage stellen und die KI-Antwort von Reddit mit zitierten Kommentaren, Quellbeiträgen und empfohlenen Subreddits erhalten.