Fundamentale Prinzipien der zeitlichen Datenrecherche
Reddit Posts API erschließt ein unabhängiges historisches Reddit-Archiv, ohne offizielle Verbindung zu Reddit und ohne Echtzeitdaten. Vollständige Abdeckung, unveränderliche Inhalte und dauerhafte Verfügbarkeit werden nicht garantiert. Prüfen Sie eine kleine Auswahl, bevor Sie ein Thema wie Fotoausrüstung über einen Zeitraum untersuchen. Ein gefundener Datensatz beweist weder den vollständigen Bestand einer Epoche noch den heutigen Zustand seiner ursprünglichen Seite.
Starten Sie mit GET https://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3. subreddit wählt die Community, min_score setzt eine Mindestpunktzahl und limit fordert bis zu drei Beiträge an. Das sortiert nicht nach Popularität und wählt nicht automatisch Kameras oder Objektive aus. Prüfen Sie Texte und dokumentieren Sie Einschlussregeln. Auch eine erfolgreiche leere Antwort kostet einen Credit.
from und to sind YYYY-MM-DD in UTC, wobei to den gesamten Endtag einschließt. Die Parameter unterstützen keine Uhrzeiten innerhalb eines Tages. Wenn Ihre Frage von lokalen Daten ausgeht, dokumentieren Sie deren Zuordnung zu UTC-Tagen. Diese Entscheidung ist keine native Filterung nach der lokalen Uhrzeit einzelner Autoren. Eine Datumsgrenze definiert Auswahlbedingungen, ohne zu beweisen, dass alle passenden Inhalte vorliegen.
Technische Filter und Abfrageparameter
Für aufeinanderfolgende Abschnitte kann der nächste from der Tag nach dem vorherigen to sein. Wiederholen Sie dasselbe Kalenderdatum an beiden Grenzen, entsteht wegen des einschließenden to eine Überschneidung. Notieren Sie bewusst gewählte Überlappungen. Diese Planung beweist weder das Fehlen von Duplikaten noch eine lückenlose Sammlung oder unveränderte Antworten zwischen entfernten Abfragen. Notieren Sie außerdem die Ausführungszeit jedes Abschnitts.
Der Parameter min_score fungiert ausschließlich als Filter und nicht als Sortierkriterium. Das bedeutet, dass alle Ergebnisse mit einer Punktzahl unter dem angegebenen Wert aus der Ergebnismenge ausgeschlossen werden, aber die verbleibenden Ergebnisse nicht nach ihrer Punktzahl sortiert werden. Diese Unterscheidung ist entscheidend für Analysten, die sicherstellen müssen, dass sie nur hochbewertete Inhalte untersuchen, ohne die Reihenfolge der Daten zu verändern.
Pro Anfrage gelten bis zu 100 Datensätze, pro Abfrage bis zu 100 Seiten. Die interne Dokumentreihenfolge _doc ist weder chronologisch noch nach Relevanz oder Punktzahl sortiert. Für eine Zeitleiste sortieren Sie lokal nach verfügbaren Feldern und kennzeichnen fehlende Werte. Eine Datumsfilterung ändert die Reihenfolge nicht und erlaubt keine Behauptung, den gesamten zeitlichen Verlauf wiederhergestellt zu haben.
Preisstruktur, Kontoverwaltung und Grenzen
eq bedeutet eine exakte Gesamtzahl für die Abfrage, gte eine Untergrenze und unknown keine verlässliche Gesamtzahl, gegebenenfalls null. Weder ein exakter Zähler noch die letzte erlaubte Seite beweist vollständigen Abruf. Speichern Sie Originalantworten, Filter, Ausführungszeit und Transformationsversion vor dem nächsten Checkpoint. Dieser dokumentiert Fortschritt, friert aber den Index oder die Zusammensetzung späterer Antworten nicht ein.
Senden Sie Authorization: Bearer <Schlüssel> oder X-API-Key: <Schlüssel> vom Server. 400 bedeutet ungültige Parameter, 401 Schlüsselproblem, 402 unzureichendes Guthaben und 429 Ratenbegrenzung. Ungültige Anfragen verursachen keinen Abzug; Fehler des Suchanbieters geben die Reservierung zurück. Ein Verbindungsabbruch des Clients kann nach einem berechneten Erfolg auftreten und jede erfolgreiche Wiederholung kostet einen weiteren Credit.
Lesen Sie Dokumentation für die Filter, Preise für das Anfragebudget und API-Schlüssel generieren für den Zugang. /v1/status ist öffentlich und kostenlos, beschreibt jedoch nur statisch den Dienstumfang und eine HTTP-Antwort, ohne Suche oder Datenverfügbarkeit zu testen. Antworten sind flach; parent_id oder link_id erlauben bei Vorhandensein lokale Gruppierung ohne vollständige Gesprächsgarantie. Wiederholtes Verarbeiten gespeicherter Dateien prüft Ihre Methode, nicht die Unveränderlichkeit des Archivs.
