Rute dan autentikasi Parameter dan batas hasil Biaya, kesalahan dan pemeriksaan lokal Rute dan autentikasi Gunakan https://api.redditextract.com sebagai host. GET /v1/search untuk pencarian umum, /v1/posts untuk postingan dan /v1/comments untuk komentar. /v1/item memerlukan id untuk satu rekaman yang diketahui. /v1/subreddits menerima prefix dan limit untuk pencarian nama komunitas; jangan mengirim filter isi atau page ke rute ini. /v1/status terbuka tanpa kunci dan menampilkan keterangan statis layanan.
Authorization: Bearer YOUR_API_KEY dan X-API-Key: YOUR_API_KEY adalah dua pilihan yang sah. Keduanya membawa kunci arsip domain ini, bukan token OAuth Reddit. Akun, kunci, dan saldo tidak berlaku di seluruh jaringan merek. Cookie sesi Secure HttpOnly pada panel akun terpisah dari header pengambilan. Letakkan nilai kunci asli pada server, bukan dalam berkas contoh, halaman publik, atau log yang dibagikan.
Pengambilan isi menghasilkan rekaman datar, bukan pohon utas yang dirakit server. Bidang dapat berbeda antarrekaman; jangan menganggap semua jenis isi mempunyai seluruh kolom yang sama. parent_id dan link_id, bila tersedia, boleh dipakai untuk pengelompokan lokal. Keduanya bukan filter kueri dan tidak mengembalikan leluhur yang hilang. API tidak menyediakan pemetaan otomatis ke tabel tujuan Anda.
Parameter dan batas hasil Rute pencarian, postingan dan komentar mendukung q, subreddit, author, kind, from, to, min_score, limit, dan page. kind menerima post atau comment. Tanggal menggunakan YYYY-MM-DD dalam UTC; to mencakup hari akhir seluruhnya. min_score menyaring nilai minimum, bukan mengurutkan hasil. id hanya untuk /v1/item, bukan parameter tambahan pada daftar postingan atau komentar. Parameter di luar kontrak dapat ditolak. Filter from dan to diterapkan pada created_utc, yaitu waktu pembuatan konten, bukan waktu pengambilan data atau pemasukan ke arsip.
limit dan page berada dalam rentang 1–100. Hasil memakai urutan dokumen _doc, bukan kronologi, relevansi atau skor. Relasi total eq menunjukkan angka tepat, gte batas bawah, dan unknown total yang tidak andal atau tidak diketahui; nilai total bisa null. Jangan mengubah batas bawah menjadi hitungan pasti. Iterasi halaman, pembagian tanggal dan deduplikasi tidak menjamin pengambilan semua kecocokan arsip.
Untuk menguji pemetaan, ambil https://api.redditextract.com/v1/search?q=index&subreddit=PostgreSQL&limit=3. Catat jenis yang benar-benar terlihat pada setiap bidang, bukan hanya bidang pada rekaman pertama. Bedakan bidang hilang dari null dan teks kosong. Bila jenis tidak sesuai target, simpan alasan penolakan lokal. Jumlah baris tujuan dapat berbeda dari jumlah rekaman karena keputusan transformasi Anda, bukan karena API menghitung ulang hasil. Pemilihan kolom dilakukan setelah respons diterima; jangan menambahkan parameter fields yang tidak didokumentasikan untuk meminta skema khusus dari server.
Biaya, kesalahan dan pemeriksaan lokal 400 menandakan permintaan tidak valid, 401 kunci tidak ada atau tidak valid, 402 kredit tidak cukup, dan 429 batas laju. Permintaan tidak valid tidak didebit; kegagalan sistem hulu mengembalikan kredit yang dicadangkan. Keberhasilan kosong tetap memakai satu kredit. /v1/status tidak memeriksa mesin pencarian, isi arsip, kunci atau saldo. Periksa kegagalan pada tahap yang benar sebelum memilih tindakan berikutnya.
Klien yang kehabisan waktu tunggu mungkin kehilangan respons setelah server berhasil. Pengulangan yang berhasil dapat memakai kredit tambahan. Sebaliknya, mengubah pemetaan atas respons yang sudah Anda simpan bukan panggilan API baru. Simpan keluaran asli, versi aturan, dan hasil penulisan terpisah. Langkah ini membantu menjelaskan proses lokal tanpa menjamin bahwa server akan mengembalikan rekaman identik pada masa mendatang.
Satu kredit bernilai $0,001; 1.000 pengambilan berhasil berharga $1. Isi ulang minimum $50 memberi 50.000 kredit berbayar, bukan batas jumlah baris yang dijamin. Seratus kredit percobaan tergantung kelayakan pencegahan penyalahgunaan jaringan. Akun menampilkan kunci sebelum pembayaran. Rencanakan jumlah panggilan terpisah dari jumlah percobaan normalisasi lokal agar biaya ekstraksi tidak disamakan dengan biaya pemrosesan Anda.
