Carousell API: iklan barang bekas dalam JSON
Carousell tidak menyediakan API terbuka untuk pengembang. Yang dikembalikan di sini adalah yang ditampilkan publik: judul, deskripsi apa adanya, harga, dan status iklan — dalam bentuk JSON. Satu hal yang berguna untuk pemantauan: daftar iklan penjual juga menyertakan yang sudah dipesan, jadi Anda bisa melihat apa yang benar-benar laku.
Endpoint
| endpoint | Apa yang dikembalikan | Wajib |
|---|---|---|
| search | Pencarian iklan di satu negara dengan kata kunci atau kategori, 48 per halaman. | semua opsional |
| listing | Iklan lengkap dari id atau URL: judul, deskripsi penuh, harga dan mata uang (termasuk gratis). | listing_id |
| seller_listings | Iklan satu penjual di satu storefront, terbaru dulu, 40 per halaman, termasuk yang sudah dipesan. | username |
| suggest | Saran kata kunci Carousell untuk satu negara, beserta kategori tiap saran. | query |
Setiap panggilan dihitung dalam kredit. Panggilan yang gagal dan diblokir gratis.
Contoh yang berjalan
Kalau ingin tahu harga yang benar-benar diterima pasar, lihat iklan penjual yang berstatus sudah dipesan. Harga yang masih terpasang hanya menunjukkan harapan penjual, bukan harga transaksi.
curl -X POST https://api.reefapi.com/carousell/v1/search \
-H "x-api-key: KUNCI_ANDA" \
-H "content-type: application/json" \
-d '{"query": "iphone", "country": "id"}'{
"ok": true,
"data": {
"results": [
{
"listing_id": "...",
"title": "...",
"price": 4500000,
"currency": "IDR",
"status": "..."
}
]
},
"meta": { "record_count": 48, "cache_hit": false, "mode": "live" }
}Daripada menulis scraper Carousell sendiri
Scraper Carousell buatan sendiri jalan di hari pertama. Masalahnya datang belakangan: susunan kartu berubah dan parser mengembalikan daftar kosong tanpa error, lalu proteksi bot memutus proses panjang di tengah jalan. Keduanya terlihat sama di sisi Anda.
Di sini perawatan ada di pihak kami: skema berubah kami perbaiki, diblokir berarti kode error dan panggilan itu tidak ditagih.
Untuk pekerjaan sekali jalan, skrip sendiri lebih murah dan kami katakan apa adanya. Untuk pemantauan harian, biayanya ada pada kerusakan yang tidak terlihat.
Dokumentasi lain dalam bahasa Indonesia
Batasan dan catatan jujur
- Ini bukan API resmi Carousell dan kami tidak punya kemitraan dengan Carousell.
- Tiap negara adalah storefront terpisah dengan mata uang sendiri.
- Kalau iklan tidak mencantumkan harga (misalnya digratiskan), kolomnya berisi null — kami tidak mengarang angka.
- Tidak ada cache: setiap panggilan menampilkan kondisi saat itu.