Getir API: katalog ve indirimli ürünler JSON olarak
Getir'in geliştiricilere açık bir API'si yok. Burada dönen şey uygulamanın ve sitenin herkese gösterdiği katalog: ürün, marka, paket boyutu, fiyat ve indirim. Hesap gerekmez, yanıt JSON gelir. Fiyat takibi yapıyorsanız en doğrudan uç `deals`: üzeri çizili fiyatı olan her ürünü tek çağrıda verir.
Uçlar
| endpoint | Ne döndürür | Zorunlu |
|---|---|---|
| search | Anahtar kelimeyle arama; tüm katalogda ya da tek bir kategoride. | query |
| product/detail | Tek ürünün tamamı: başlık, marka, paket boyutu, bütün görseller ve fiyat. id, slug ya da getir.com adresiyle çağrılır. | product_id |
| category | Bir ana kategorinin (isterseniz içindeki tek bir rafın) bütün ürünleri, Getir'in kendi raf sırasıyla. | category |
| categories | Kategori ağacı: 17 ana kategori, id'leri, slug'ları, görselleri ve ürün sayıları. | hepsi opsiyonel |
| deals | İndirimli ürünler: üzeri çizili fiyatı olan her ürün, katalogun tamamında ya da tek kategoride. | hepsi opsiyonel |
Her çağrı kredi ile ücretlendirilir. Başarısız ve engellenen çağrılar ücretsizdir.
Çalışan örnek
İndirim takibi için ürünleri tek tek gezmek gerekmiyor; `deals` indirimli olanların hepsini birden veriyor. Aynı işi aramayla yapmak hem yavaş hem gereksiz kredi harcar.
curl -X POST https://api.reefapi.com/getir/v1/deals \
-H "x-api-key: ANAHTARINIZ" \
-H "content-type: application/json" \
-d '{}'{
"ok": true,
"data": {
"results": [
{
"product_id": "...",
"title": "...",
"brand": "...",
"price": 54.9,
"struck_price": 79.9
}
]
},
"meta": { "record_count": 120, "cache_hit": false, "mode": "live" }
}Getir için kendi scriptinizi yazmak yerine
Getir kataloğunu kendiniz çekmek ilk gün çalışır. Sonrasında iki şey oluyor ve ikisi de sessiz: site 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 engellenir. Her ikisi de sizin tarafınızda 'ürün yok' gibi 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. Günlük çalışan bir indirim takibi kuruyorsanız maliyet kodda değil, fark edilmeyen kırılmalarda birikir.
Sınırlar ve dürüst notlar
- Bu Getir'in resmi API'si değildir ve Getir ile bir ortaklığımız yoktur.
- Katalog herkese açık olanı kapsar; uygulamada hesaba ya da bölgeye özel görünen kampanyalar burada yoktur.
- Ürünün indirimi yoksa üzeri çizili fiyat alanı null gelir; normal fiyat indirimli gibi gösterilmez.
- Her çağrı canlıdır, önbellekten yanıt dönmez.