Rute dan kredensial
Host pengambilan adalah https://api.getredditdata.com. GET /v1/search untuk pencarian umum, /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 adalah pengungkapan statis layanan. Arsip historis independen ini bukan layanan resmi Reddit dan tidak menyediakan data langsung, OAuth, operasi tulis, pemungutan suara, atau pesan pribadi. Data yang cocok dengan kueri bukan sampel representatif seluruh platform atau layanan pemulihan setiap konten yang dihapus.
Authorization: Bearer YOUR_API_KEY dan X-API-Key: YOUR_API_KEY adalah dua header yang valid. Gunakan kunci arsip domain ini, bukan token OAuth Reddit. Isi nilai asli pada server dan jangan menaruhnya dalam kode publik atau tabel. Cookie sesi Secure HttpOnly pada panel terpisah dari autentikasi pengambilan. Akun, kunci, dan saldo tidak dibagikan ke merek lain. Contoh GET https://api.getredditdata.com/v1/search?q=sampling&subreddit=AskStatistics&limit=3 tidak memilih sampel acak atau menjamin tiga hasil. Konversi tabel dilakukan oleh aplikasi Anda, bukan ekspor atau analisis otomatis dari API.
Filter dan makna rekaman
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 minimum, bukan pengurutan atau ukuran kualitas. id hanya untuk /v1/item dan bukan filter daftar postingan atau komentar. parent_id dan link_id dapat muncul pada respons tetapi tidak tersedia sebagai filter kueri. Jelaskan pilihan parameter dalam metode penelitian dan jangan menerjemahkan nama parameter saat mengirim permintaan.
Batasnya 100 rekaman per permintaan dan 100 halaman per kueri; setiap halaman merupakan panggilan tersendiri. Hasil mengikuti urutan dokumen arsip, bukan waktu, relevansi, atau skor. eq menunjukkan total tepat, gte batas bawah, dan unknown atau null total tepercaya yang tidak diketahui. Satuannya rekaman, bukan halaman. Total tepat tidak membuktikan klien telah menerima atau menyimpan semuanya. Respons datar dapat dikelompokkan secara opsional untuk analisis hubungan; membaca dan menghitung tidak memerlukan pohon. Induk yang hilang tidak dipulihkan, dan hitungan komunitas bukan inventaris global yang pasti.
Kesalahan, biaya, dan status
Setiap pengambilan berhasil termasuk hasil kosong menggunakan satu kredit; 1.000 keberhasilan berharga $1. Permintaan tidak valid tidak didebit dan kegagalan sistem hulu mengembalikan kredit cadangan. Waktu tunggu habis di klien tidak membuktikan kegagalan server; pengulangan yang berhasil dapat dikenai kredit tambahan setelah respons hilang. Baca saja tidak menjamin isi tetap atau percobaan gratis. Pisahkan status API dari hasil penyimpanan dan transformasi tabel. Memproses JSON lokal yang sudah diterima berbeda dari mengambilnya kembali melalui panggilan baru.
400 memerlukan koreksi parameter atau nilai, 401 pemeriksaan kunci hilang atau tidak valid, 402 pemeriksaan saldo, dan 429 pengurangan laju. Batasi percobaan ulang serta tetapkan kondisi berhenti; jangan menghindari batas melalui akun lain. /v1/status publik tanpa biaya hanya menunjukkan cakupan statis dan respons HTTP, bukan pencarian, rekaman, kunci, atau saldo. Pembagian tanggal, iterasi halaman, dan deduplikasi tidak menjamin hasil lengkap tanpa pengulangan. Catat kondisi, halaman yang diterima, transformasi lokal, dan ketidakpastian. Catatan itu pun tidak menjamin hasil yang sama tersedia kembali di masa depan.
