reddit/
search

Öffentliche Reddit-Beiträge per Suchanfrage und Veröffentlichungszeitraum durchsuchen – mit normalisierten Titeln, Text, Autoren, Community-Kontext, Zeitstempeln, Medien und sichtbarer Interaktion.

Reddit Search API

Beitragssuche
Veröffentlichungszeitraum
Kontext der Suche
0,6 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 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

ParameterErforderlichBeschreibung
queryErforderlichErforderlicher, nicht leerer Text, mit dem öffentliche Reddit-Beiträge gefunden werden.
results_limitOptionalMaximale Anzahl der angeforderten Beiträge. Der Standardwert ist 100; akzeptiert werden ganze Zahlen von 1 bis 2.000.
published_withinOptionalVerö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.

  1. Bereiten Sie eine nicht leere Textabfrage vor und wählen Sie optional ein Zeitfenster für published_within und ein results_limit.
  2. Senden Sie die Parameter per POST an /v1/reddit/search 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/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 true

Anwendungsfä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.

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.

Weitere Plattformen entdecken

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

Reddit Search API — FAQ

Reddit Search API findet öffentliche Beiträge anhand einer nicht leeren Textabfrage, optional mit Veröffentlichungszeitraum und Obergrenze für Ergebnisse. Die Schnittstelle liefert normalisierten Beitragsinhalt, Autoren, Subreddit-Kontext, Medien, Zeitstempel, sichtbare Interaktion und die Sucheingabe.

Die Anfrage akzeptiert query, results_limit und published_within. query ist erforderlich; der Endpunkt bietet keine Steuerung für Subreddit-URL, Inhaltstyp oder Sortierung.

Jeder normalisierte Beitrag kann ID, URL, Titel, Text, Autor, Community-Kontext, Medien, Veröffentlichungs- und Erfassungszeit, sichtbare Upvotes und Kommentare, das Upvote-Verhältnis und die Sucheingabe enthalten.

published_within akzeptiert hour, day, week, month, year oder all. Der Standardwert ist all.

results_limit hat den Standardwert 100 und akzeptiert als angeforderte Obergrenze ganze Zahlen von 1 bis 2.000. Nach dem Erfolg der Aufgabe folgen Sie next_cursor, solange has_more den Wert true hat, um alle gespeicherten Ergebnisseiten zu lesen.

Jedes zurückgegebene normalisierte Suchergebnis kostet 0,6 SocQ-Credits. Für eine leere Ergebnismenge fällt keine Ergebnisgebühr an.