Rute dan autentikasi
Host pengambilan adalah https://api.redditdatasets.com. GET /v1/search untuk pencarian, /v1/posts untuk postingan, dan /v1/comments untuk komentar. /v1/item?id=... mengambil item dengan pengenal yang diketahui; /v1/subreddits?prefix=... mencari nama komunitas berdasarkan awalan. /v1/status mengungkap cakupan statis layanan. Arsip historis independen ini bukan layanan resmi Reddit dan tidak menyediakan data langsung, Reddit OAuth, operasi tulis, pemungutan suara, atau pesan pribadi. Rute tersebut mengambil rekaman dengan filter, bukan dataset berlabel, unduhan massal, sampel acak, atau versi arsip yang tetap. Catatan pemilihan dan anotasi dibuat pengguna sendiri.
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 di server dan keluarkan dari berkas serta log yang dibagikan. Cookie sesi Secure HttpOnly panel terpisah. Akun, kunci, dan saldo tidak dibagikan ke merek lain. Contoh https://api.redditdatasets.com/v1/comments?subreddit=MachineLearning&limit=3 meminta paling banyak tiga komentar, tanpa menjamin tiga hasil. Halaman pertama tidak dipilih secara acak. Catat komunitas, batas yang diminta, dan jumlah yang benar-benar tersimpan sebagai informasi yang berbeda.
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.
Parameter min_score berfungsi murni sebagai filter, bukan pengurut hasil. Field id hanya diperlukan untuk endpoint item tunggal, sementara pencarian postingan dan komentar tidak membutuhkannya. Struktur respons tidak menyertakan filter parent_id atau link_id yang terpisah. Klien harus memproses data mentah ini dengan hati-hati untuk menjamin akurasi validasi data.
Kesalahan, biaya, dan berkas
Pengambilan berhasil termasuk hasil kosong memakai satu kredit; 1.000 keberhasilan berharga $1. Permintaan tidak valid tidak didebit dan kegagalan sistem hulu mengembalikan kredit yang dicadangkan. Waktu tunggu habis pada klien tidak membuktikan kegagalan server. Respons yang hilang dapat diikuti pengulangan berhasil yang memakai kredit lagi. Akses baca saja tidak menjamin respons identik atau percobaan gratis. Pisahkan hasil API, penyimpanan, pembersihan teks, dan keputusan anotasi. Memproses respons tersimpan bukan panggilan baru. Nama versi berkas lokal tidak membuktikan server menyediakan salinan tetap atau menjamin sampel yang sama dapat diambil kembali.
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.
