Pazarama API: ürün ve kategori verisini JSON olarak okuyun
Pazarama'nın kendi satıcı entegrasyonu mağaza sahipleri içindir ve size yalnızca kendi ürünlerinizi verir. Bu API vitrinin tamamını okur: herhangi bir ürünün fiyatı ve barkodu, bir kategorinin ya da markanın listesi, ve ürün yüklerken kullanılan kategori şablonunun tamamı. Satıcı hesabı gerekmez.
Uçlar
| endpoint | Ne döndürür | Zorunlu |
|---|---|---|
| search | Anahtar kelimeyle arama, ya da bir kategori veya marka listesini gezme. Fiyat aralığı ve sıralama destekleniyor. | hepsi opsiyonel |
| product/detail | Tek ürünün tamamı: başlık, marka, barkod, satıcı, fiyat ve görseller. Ürün adresiyle ya da ürün kodu + satıcı ile çağrılır. | hepsi opsiyonel |
| seller/categories | Pazarama'nın satıcı kategori ağacı: her kategori, UUID biçimindeki id'si ve tam yolu. Ürün yüklemede kullanılan ağacın kendisi. | hepsi opsiyonel |
| seller/category-attributes | Bir kategorinin ürün yükleme şablonu: her özellik, zorunlu olup olmadığı ve izin verilen değerleri. | category_id |
Her çağrı kredi ile ücretlendirilir. Başarısız ve engellenen çağrılar ücretsizdir.
Çalışan örnek
Pazarama'ya ürün yüklemek için hangi alanların zorunlu olduğunu merak ediyorsanız, kategori şablonu ucu bunu doğrudan söyler. Önce kategori ağacından id'yi alın, sonra şablonu isteyin.
curl -X POST https://api.reefapi.com/pazarama/v1/search \
-H "x-api-key: ANAHTARINIZ" \
-H "content-type: application/json" \
-d '{"query": "bluetooth kulaklık", "page": 1}'{
"ok": true,
"data": {
"results": [
{
"product_code": "...",
"title": "...",
"brand": "...",
"price": 899.0,
"seller": "..."
}
]
},
"meta": { "record_count": 24, "cache_hit": false, "mode": "live" }
}Pazarama için kendi scriptinizi yazmak yerine
Pazarama sayfalarını kendiniz ayrıştırmak ilk gün çalışır. Sonrasında iki şey oluyor: site kart yapısını değiştirdiğinde ayrıştırıcınız hata vermeden boş liste döndürür, bot koruması devreye girdiğinde istek sessizce engellenir. İkisi de sizin tarafınızda aynı görünür.
Burada bakım bizde: şema değişirse motoru biz düzeltiriz, engellenme olursa açık bir hata kodu döner ve o çağrı ücretsizdir.
Tek seferlik bir çıkarım için kendi scriptiniz daha ucuz, bunu dürüstçe söylüyoruz. Düzenli çalışacak bir fiyat ya da katalog takibi kuruyorsanız hesap tersine döner.
Sınırlar ve dürüst notlar
- Satıcı hesabı gerekmez, ama bu Pazarama'nın resmi API'si değildir ve onunla bir ortaklığımız yoktur.
- Kategori id'leri UUID biçimindedir, sayısal değil; şablon ucuna o id verilir.
- Satıcı yayımlamıyorsa barkod ve bazı özellik alanları null gelir; biz tahmin üretmiyoruz.
- Her çağrı canlıdır, önbellekten yanıt dönmez.