Reddit Search API

Pencarian data Reddit historis untuk aplikasi Anda

Bangun aplikasi pencarian postingan dan komentar Reddit historis. Pelajari filter, batas hasil, penafsiran total, serta biaya per permintaan yang berhasil.

Dapatkan kunci API

Contoh permintaan

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditsearchapi.com/v1/search?q=quantization&subreddit=LocalLLaMA&limit=3"

Mulai dari pertanyaan pencarian yang jelas

Reddit Search API menyediakan akses ke arsip historis Reddit yang independen. Layanan ini bukan layanan resmi Reddit dan tidak berafiliasi dengan Reddit. Data yang dicari bukan aliran langsung dari aktivitas terbaru. Jika Anda membangun antarmuka pencarian, jelaskan sumber arsip tersebut agar pengguna tidak mengira bahwa setiap postingan baru atau perubahan di Reddit akan langsung terlihat dalam aplikasi.

Gunakan q untuk teks pencarian, subreddit untuk komunitas, dan author untuk penulis. Parameter kind menerima nilai post atau comment sehingga aplikasi dapat membedakan postingan dan komentar. Rentang tanggal membantu menentukan lingkup penyelidikan. Pilihan tersebut berguna untuk menyusun pencarian yang terarah, tetapi tidak membuktikan bahwa arsip memiliki semua rekaman yang sesuai dengan pertanyaan pengguna.

Sebagai contoh penggunaan, sebuah alat riset produk dapat mencari pembahasan suatu istilah di komunitas tertentu dalam rentang tanggal pilihan. Contoh ini menggambarkan cara menggabungkan filter, bukan janji adanya data untuk produk atau periode tertentu. Periksa respons kueri kecil terlebih dahulu. Setelah itu, tentukan bagaimana aplikasi akan menampilkan rekaman, menyimpan hasil, dan menjalankan analisis lokal.

Tampilkan batas hasil dengan jujur

Satu permintaan mengembalikan paling banyak 100 rekaman. Satu kueri dapat dijelajahi hingga 100 halaman melalui permintaan terpisah. Menelusuri semua halaman yang diizinkan tidak menjamin semua kecocokan telah diperoleh. Dalam tampilan jumlah hasil, bedakan total tepat, batas bawah, dan total yang tidak diketahui. Jumlah rekaman yang sedang terlihat juga berbeda dari jumlah seluruh kecocokan kueri.

Hasil mengikuti urutan dokumen internal arsip, yaitu _doc. Urutan ini bukan urutan waktu, relevansi, atau skor. min_score hanya menerapkan ambang skor minimum dan tidak menempatkan rekaman berskor tertinggi di awal. Jika aplikasi mengurutkan rekaman yang sudah diambil, beri label bahwa pengurutan hanya berlaku pada hasil lokal tersebut, bukan pada seluruh isi arsip.

Respons berisi rekaman datar, bukan pohon percakapan yang dirakit server. Jika parent_id dan link_id tersedia, aplikasi dapat mengelompokkan rekaman secara lokal. Hubungan tersebut tidak menjamin percakapan atau rantai induk yang lengkap. Simpan respons mentah bersama parameter kueri untuk menjelaskan dasar analisis. Menjalankan kueri yang sama di kemudian hari tidak dijamin menghasilkan rekaman atau urutan yang sama.

Perhitungkan akses dan biaya sejak awal

Setiap permintaan pengambilan yang berhasil menggunakan 1 kredit, termasuk hasil kosong. Biayanya 1 dolar AS per 1000 permintaan berhasil. Isi ulang berbayar minimum 50 dolar AS memberikan 50000 kredit berbayar. Tidak ada langganan dan kredit yang dibeli tidak kedaluwarsa. Akun yang memenuhi syarat pencegahan penyalahgunaan di seluruh jaringan dapat memperoleh 100 kredit percobaan.

Kunci API ditampilkan sekali saat pendaftaran email dan kata sandi, sebelum pembayaran. Simpan kunci tersebut dan gunakan header X-API-Key untuk mengambil data. Panel akun tersedia di halaman kunci. Untuk menambah saldo, masuk lalu buat faktur, kirim jumlah persis ke penerima yang tercantum, tempel hash transaksi, dan minta verifikasi. Kunci dan saldo hanya berlaku pada domain ini.