Authentifizierung und Zeitfenster-Filterung
Senden Sie GET-Anfragen an api.redditpostsapi.com mit Authorization: Bearer <Schlüssel> oder X-API-Key: <Schlüssel> für authentifizierte Abrufe. Beide Varianten werden unterstützt. /v1/status ist öffentlich und benötigt keinen Schlüssel. Das Secure-HttpOnly-Sitzungscookie des Kontobereichs ersetzt keinen API-Header. Schlüssel und Saldo sind auf dieses Domainkonto begrenzt. Halten Sie Zugangsdaten aus Forschungsdateien und öffentlichen Diagnoseprotokollen heraus.
Datumsfilter heißen from und to und akzeptieren YYYY-MM-DD in UTC. to schließt den gesamten Endtag ein; Uhrzeiten innerhalb eines Tages werden nicht unterstützt. Dokumentieren Sie bei einer Fragestellung mit lokalen Daten deren Zuordnung zu UTC-Tagen. Diese Zuordnung ist eine Entscheidung Ihrer Analyse, keine native Filterung nach der lokalen Uhrzeit jedes Autors. Eine Datumsgrenze verspricht keine Archivabdeckung.
Suchparameter sind q, subreddit, author, kind, from, to, min_score, limit und page. kind akzeptiert post oder comment; /v1/posts wählt Beiträge und /v1/comments Kommentare. Nur /v1/item verlangt id für einen bekannten Datensatz. /v1/subreddits unterstützt prefix und limit zur Namenserkundung, ohne garantiert global exakte Aggregationen. Es gibt keine serverseitigen Filter für parent_id oder link_id.
Ergebnisgrenzen und Datensatzstruktur
limit und page liegen zwischen 1 und 100. Eine Anfrage erhält eine Seite mit höchstens 100 Datensätzen, jede Abfrage erlaubt bis zu 100 Seiten. eq bezeichnet die exakte Gesamtzahl für die Abfrage, gte eine Untergrenze und unknown keine verlässliche Gesamtzahl, gegebenenfalls null. Weder eine exakte Zahl noch das Durchlaufen der Seiten beweist vollständige Erfassung oder das Fehlen von Duplikaten.
Die zurückgegebenen Datensätze sind flache Objekte, die keine serverseitig zusammengesetzten Thread-Bäume enthalten. Wenn Felder wie parent_id oder link_id vorhanden sind, müssen diese vom Client lokal gruppiert werden, um Unterhaltungen zu rekonstruieren. Es gibt keine Serverfilter für diese Felder, was bedeutet, dass die API keine vollständige Ahnenkette garantiert. Die Felder sind optional vorhanden, und ihre Abwesenheit bedeutet nicht zwingend, dass keine Verbindung besteht, sondern dass sie nicht in diesem spezifischen Datensatz enthalten sind. Diese Struktur erfordert eine Client-seitige Logik, um die Beziehung zwischen Beiträgen und Kommentaren korrekt darzustellen.
Die Ausgabe folgt _doc, der internen Dokumentreihenfolge, weder chronologisch noch nach Relevanz oder Punktzahl sortiert. min_score setzt ausschließlich einen Schwellenwert. Er garantiert keine Inhaltsqualität und friert weder Daten noch Reihenfolge künftiger Antworten ein. Für eine Zeitleiste sortieren Sie die erhaltenen Datensätze lokal nach verfügbaren Feldern und kennzeichnen fehlende Werte. Daraus folgt keine vollständige zeitliche Rekonstruktion.
Fehlercodes, Status und Kostenabrechnung
400 bedeutet ungültige Parameter, 401 fehlender oder ungültiger Schlüssel, 402 unzureichendes Guthaben und 429 Ratenbegrenzung. Jeder erfolgreiche Abruf kostet einen Credit, auch ohne Treffer. Ungültige Anfragen verursachen keinen Abzug; Fehler des Suchanbieters geben die Reservierung zurück. Ein Client-Verbindungsabbruch kann nach einem berechneten Erfolg auftreten und ein erfolgreicher erneuter Versuch kostet einen weiteren Credit. Begrenzen Sie Wiederholungen und prüfen Sie Fehlerursachen.
Die Prüfung des Systemstatus über /v1/status ist öffentlich und kostet nichts, gibt jedoch nur eine statische Offenlegung über den historischen Archivcharakter wieder. Sie überprüft nicht die Funktionsfähigkeit des Such-Backends oder die Verfügbarkeit bestimmter Datensätze. Der Server gibt lediglich an, dass die HTTP-Verbindung aktiv ist. Für tiefere Einblicke in die Datenintegrität muss die API selbst abgefragt werden. Diese Trennung der Verantwortlichkeiten ermöglicht eine schnelle Statusprüfung ohne Kosten, liefert aber keine Garantie für die Vollständigkeit oder Aktualität der archivierten Daten im Vergleich zu einer Live-Suche.
$1 kauft 1000 Credits und die Mindestaufladung von $50 kauft 50000. Gekaufte Credits verfallen nicht und es gibt kein Abonnement. Erstellen Sie nach Anmeldung vor der Überweisung eine Rechnung, folgen Sie Empfänger und exaktem Betrag und fordern Sie die Prüfung mit dem Transaktionshash an. Nur eine echte bestätigte Überweisung ergänzt den Saldo, ohne garantierten Zeitrahmen. Auch erfolgreiche leere Wiederholungen kosten jeweils einen Credit.
Die photography-Auswahl prüfen
Beginnen Sie mit /v1/posts?subreddit=photography&min_score=10&limit=3 und prüfen Sie, welche Texte Ausrüstung betreffen. Fügen Sie dann from und to hinzu. Für aufeinanderfolgende Tage kann der nächste Abschnitt am Tag nach dem vorherigen Enddatum beginnen. So beschreiben Sie Grenzen, ohne Lückenfreiheit zu versprechen. Speichern Sie Originalantworten, Parameter und Regeln vor dem nächsten Checkpoint; dieser friert den entfernten Index nicht ein.
