Rute dan autentikasi
Host pengambilan adalah https://api.redditdatastream.com. GET /v1/search untuk pencarian, /v1/posts untuk postingan, dan /v1/comments untuk komentar. /v1/item?id=... mengambil item yang pengenalnya diketahui; /v1/subreddits?prefix=... mencari nama komunitas berdasarkan awalan. /v1/status mengungkap cakupan statis. Arsip historis independen ini bukan layanan resmi Reddit dan tidak menyediakan aliran langsung, umpan perubahan, SSE, WebSocket, OAuth, operasi tulis, pemungutan suara, atau pesan pribadi. Klien meminta halaman dan mengolahnya sendiri. Ekspor JSONL siap pakai serta verifikasi penulisan berkas lokal oleh server tidak tersedia.
Authorization: Bearer YOUR_API_KEY dan X-API-Key: YOUR_API_KEY valid. Gunakan kunci arsip domain ini, bukan token OAuth Reddit. Tambahkan nilai asli pada server dan keluarkan dari berkas serta log. Cookie sesi Secure HttpOnly panel terpisah. Akun, kunci, dan saldo tidak dibagikan ke merek lain. Contoh https://api.redditdatastream.com/v1/posts?subreddit=apacheairflow&limit=3&page=3 meminta halaman ketiga, bukan menjamin tiga hasil. page bukan kursor kelanjutan yang tetap atau batas waktu. Menyimpan nomor yang sama tidak menciptakan jaminan memulai ulang tanpa kehilangan atau memperoleh snapshot yang identik.
Filter, urutan, dan cakupan
Filter pencarian, postingan, dan komentar adalah q, subreddit, author, kind, from, to, min_score, limit, dan page. kind menerima post atau comment. Tanggal memakai YYYY-MM-DD dalam UTC; to mencakup seluruh hari. min_score adalah ambang skor minimum, bukan pengurutan atau pemeriksaan kualitas. id hanya untuk /v1/item dan bukan filter daftar postingan atau komentar. parent_id dan link_id dapat muncul pada respons tetapi bukan filter kueri. Pembagian tanggal merupakan pilihan perencanaan; tanggal rekaman terakhir bukan bukti semua periode sebelumnya sudah diambil atau batas aman masukan baru.
Maksimal 100 rekaman per permintaan dan 100 halaman per kueri dapat diminta; setiap halaman panggilan tersendiri. Urutan dokumen bukan waktu, relevansi, atau skor. eq berarti total tepat, gte batas bawah, unknown atau null total tepercaya yang tidak diketahui. Total tepat tidak membuktikan semua hasil tersimpan. Pengelompokan rekaman datar bersifat pilihan untuk hubungan; membaca atau menghitung tidak memerlukan pohon dan induk hilang tidak dipulihkan. Iterasi dan deduplikasi tidak membuktikan kelengkapan atau keunikan. Hitungan komunitas bukan inventaris global yang pasti dan pencarian awalan bukan daftar alfabetis menyeluruh.
Kesalahan, biaya, dan berkas
Pengambilan berhasil termasuk kosong memakai satu kredit; 1.000 keberhasilan berharga $1. Permintaan tidak valid tidak didebit dan kegagalan sistem hulu mengembalikan cadangan. Waktu tunggu habis pada klien tidak membuktikan kegagalan server. Respons yang hilang dapat diikuti pengulangan berhasil yang memakai kredit lagi. Baca saja tidak menjamin respons identik atau percobaan gratis. Pisahkan hasil API, penulisan JSONL, dan pemuatan tujuan. Memproses respons tersimpan bukan panggilan baru. Catatan kemajuan lokal bukan bukti server menyediakan snapshot tetap atau pengiriman tepat satu kali; periksa hasil setiap tahap.
400 memerlukan koreksi parameter, 401 pemeriksaan kunci, 402 saldo, dan 429 pengurangan laju. Tetapkan jumlah percobaan serta kondisi berhenti; jangan melewati batas melalui akun lain. /v1/status publik tanpa biaya hanya menunjukkan cakupan statis dan respons HTTP, bukan pencarian, rekaman, kunci, atau saldo. Periksa keberhasilan sebenarnya untuk setiap tahap pekerjaan. Kelengkapan, penyimpanan permanen, ketetapan, kinerja tertentu, dan ketersediaan terus-menerus tidak dijamin. Permintaan berkala tidak membuat catatan perubahan langsung atau membuktikan frekuensi pembaruan arsip. Dokumentasikan kondisi kueri dan alasan berhenti tanpa menyertakan rahasia autentikasi.
