Gunakan rute arsip dengan batas dan autentikasi yang tepat

Pilih rute dan kirim kunci

Gunakan alamat dasar https://api.redditscraping.com. GET /v1/search mencari posting dan komentar, /v1/posts mengambil posting, dan /v1/comments mengambil komentar. GET /v1/item?id=... meminta satu catatan melalui pengenalnya. Parameter id hanya untuk rute item; jangan menambahkannya ke kueri posts atau comments. GET /v1/subreddits?prefix=... mencari komunitas berdasarkan awalan nama, dengan limit untuk membatasi jumlah hasil yang diminta.

Permintaan pengambilan menerima Authorization: Bearer YOUR_API_KEY maupun X-API-Key: YOUR_API_KEY. Pilih salah satu header dan simpan kunci asli pada konfigurasi rahasia di server. Cookie sesi Secure HttpOnly pada panel akun mempunyai fungsi terpisah dan bukan pengganti header tersebut. Kunci hanya berlaku pada domain ini. Menggunakan kunci dari merek jaringan lain tidak memberikan akses pada akun redditscraping.com.

GET /v1/status bersifat publik dan tidak dikenai kredit. Responsnya mengungkapkan cakupan layanan yang tetap serta menunjukkan bahwa aplikasi HTTP merespons. Rute ini tidak memeriksa sumber arsip, keberhasilan kueri, ketersediaan catatan, atau saldo akun. Tangani hasil permintaan data secara terpisah. Respons status yang berhasil tidak membuktikan bahwa pekerjaan pengambilan Anda akan berhasil atau memiliki data yang diperlukan.

Atur filter dan pahami bentuk hasil

Parameter kueri pencarian, posting, dan komentar mencakup q, subreddit, author, kind, from, to, min_score, limit, serta page. Nilai kind adalah post atau comment. Masukkan tanggal dalam bentuk YYYY-MM-DD berdasarkan UTC; hari pada to termasuk dalam rentang. min_score menyaring skor minimum dan bukan pengurutan. parent_id serta link_id bukan filter kueri yang didukung, sehingga jangan mengirimkannya sebagai pengganti filter yang tersedia.

Satu permintaan dibatasi 100 catatan, dengan paling banyak 100 halaman per kueri. Ambil satu halaman dalam setiap permintaan dan catat parameter yang digunakan. Memecah pekerjaan menjadi rentang lebih sempit dapat membantu pengelolaan, tetapi tidak menjamin cakupan menyeluruh atau hasil yang unik. Urutan dokumen arsip tidak berubah menjadi urutan waktu hanya karena Anda menaikkan nomor halaman atau memberikan tanggal.

Respons data tidak menjamin urutan kronologis atau relevansi, melainkan menggunakan urutan dokumen arsip internal. Pengembang dapat mengelompokkan catatan secara lokal jika bidang parent_id atau link_id tersedia, namun ini bersifat opsional. Tidak ada jaminan kelengkapan atau urutan utas percakapan di sisi server karena struktur respons tetap datar.

Total hasil menghitung catatan, bukan halaman. Relasi eq menunjukkan total tepat, gte menunjukkan batas bawah, sedangkan unknown atau nilai null menunjukkan tidak adanya total yang dapat diandalkan. Total tepat sekalipun bukan bukti bahwa klien sudah menyimpan semua hasil. Jumlah dalam agregasi komunitas juga tidak dijamin tepat secara global. Simpan catatan pengambilan sendiri agar hasil analisis menjelaskan apa yang benar-benar diterima.

Bedakan kesalahan dan biaya

HTTP 400 meminta pemeriksaan format atau nilai parameter. HTTP 401 berarti kunci hilang atau tidak valid; HTTP 402 menunjukkan saldo tidak mencukupi. HTTP 429 menandakan batas laju permintaan telah terlewati. Perbaiki parameter, kunci, atau saldo sesuai masalahnya, dan tunda permintaan ketika terkena batas laju. Mengulang semua kesalahan dengan pola yang sama dapat menutupi penyebab dan menambah pekerjaan yang tidak berguna.

Setiap pengambilan berhasil, termasuk hasil kosong, menggunakan satu kredit. Permintaan tidak valid tidak mendebit saldo; kegagalan sumber hulu mengembalikan kredit yang dicadangkan. Hilangnya respons di jaringan klien berbeda: server mungkin sudah berhasil memproses permintaan berbayar. Pengulangan yang berhasil menggunakan satu kredit lagi. Rancang pencatatan hasil dan keputusan mengulang dengan perbedaan ini, tanpa menyimpulkan biaya hanya dari pesan kesalahan yang terlihat pada klien.