Rute dan autentikasi pembacaan
Gunakan https://api.subredditdata.com sebagai alamat dasar. /v1/search mencari catatan arsip; /v1/posts dan /v1/comments membatasi jenisnya. Ketiganya tidak memerlukan id. /v1/item memerlukan id satu catatan. /v1/subreddits mendukung prefix dan limit untuk menemukan nama komunitas, bukan profil lengkap jumlah anggota atau pertumbuhannya. /v1/status bersifat publik dan tidak memakai kredit.
Kirim kunci mentah melalui X-API-Key atau gunakan alternatif Authorization: Bearer dengan kunci yang sama. Jangan menambahkan awalan Bearer pada nilai X-API-Key. Kunci dan saldo harus milik subredditdata.com; domain lain dalam jaringan memiliki akun tersendiri. Cookie sesi Secure HttpOnly pada halaman akun berbeda dari autentikasi API. Jangan masukkan kunci nyata ke lembar kerja yang dibagikan.
Parameter isi yang didukung adalah q, subreddit, author, kind, from, to, min_score, limit, dan page. kind menerima post atau comment, tetapi tidak wajib pada search. q mencari title dan text dengan AND untuk beberapa kata yang dianalisis dalam bidang yang cocok. Kata-kata tidak harus ditemukan pada kedua bidang sekaligus. Pencarian ini bukan jaminan frasa persis atau bahasa kueri bebas.
Parameter bergantung pada rute: item menerima id, sedangkan subreddits menerima prefix dan limit. Nama parameter tidak dikenal menghasilkan kesalahan. Tidak ada filter parent_id, link_id, sentimen, atau demografi. Untuk membandingkan topik, samakan rute serta jenis catatan dan tulis bila suatu filter tidak dipakai. Perubahan istilah tetap mengubah pemilihan teks meskipun pengaturan lain sama.
Batas hari dan struktur catatan
Gunakan tanggal tepat YYYY-MM-DD. from dimulai pada tengah malam UTC; to meliputi hari tersebut sampai 23:59:59 UTC, berdasarkan created_utc. Contoh from=2026-04-01 dan to=2026-04-30 menentukan hari kalender April. Bila to adalah hari ini, seluruh hari UTC tetap menjadi batas, bukan waktu pengiriman permintaan. Aturan ini tidak menjamin data yang belum tersedia atau data masa depan.
Respons yang dikirimkan oleh server berbentuk catatan datar sederhana dan bukan merupakan struktur pohon percakapan yang telah dirakit oleh sisi server. Meskipun bidang parent_id dan link_id mungkin hadir dalam data yang dikembalikan, ini hanya memungkinkan pengelompokan lokal di sisi klien tanpa menjamin kelengkapan atau urutan ancestral yang akurat. Tidak ada filter query eksplisit yang tersedia khusus untuk bidang parent_id atau link_id pada endpoint pencarian dasar.
limit dan page berada pada rentang 1 sampai 100. Urutan _doc bukan urutan waktu, relevansi, atau skor. min_score hanya menyaring nilai minimum, bukan memilih kesaksian tepercaya. Menyelesaikan halaman yang diizinkan tidak membuktikan pengambilan menyeluruh. Pengurutan lokal berdasarkan waktu hanya merapikan catatan yang sudah dimiliki, bukan memulihkan aktivitas yang hilang.
Pada total, eq berarti nilai pasti untuk respons, gte batas bawah, dan unknown berarti total yang andal tidak tersedia, sehingga nilainya dapat null. Hubungan tersebut tidak mengukur keterwakilan atau cakupan arsip. Hitungan agregasi nama komunitas juga tidak dijamin pasti secara global. Dasarkan rangkuman lokal pada catatan yang benar-benar dibaca, dengan irisan dan pengecualian dicatat tersendiri.
Kesalahan berbeda dari respons yang tidak sampai
HTTP 400 berarti permintaan tidak valid, 401 kunci hilang atau tidak valid, 402 kredit tidak cukup, dan 429 batas laju. Perbaiki penyebab sebelum mencoba lagi. Kesalahan bukan bukti bahwa topik transit tidak pernah dibicarakan. /v1/status hanya menunjukkan respons HTTP dan penjelasan statis tentang layanan historis; ia tidak memeriksa sumber pencarian atau ketersediaan arsip.
Satu pengambilan berhasil memakai satu kredit walaupun kosong. Permintaan tidak valid tidak didebit, sedangkan kegagalan sumber hulu mengembalikan reservasi. Timeout klien atau respons hilang tidak membuktikan server gagal: permintaan mungkin telah berhasil dan ditagih. Pengulangan yang berhasil dikenai biaya tersendiri. Kegagalan pengolahan lokal setelah respons berhasil juga tidak membatalkan biaya awal.
