n11 API: ürün, fiyat ve yorumları JSON olarak okuyun
n11'in kendi entegrasyon servisleri mağaza sahipleri içindir ve size yalnızca kendi ürünlerinizi verir. Bu API ise vitrinin tamamını okur: herhangi bir ürünün fiyatı, kampanyası, yorumları ve bir mağazanın bütün kataloğu. Satıcı hesabı gerekmez.
Uçlar
| endpoint | Ne döndürür | Zorunlu |
|---|---|---|
| search | Anahtar kelimeyle arama, sayfalı ve sıralanabilir. Her kartta product_id, başlık, marka, fiyat ve puan. | query |
| product/detail | Tek ürünün tamamı: başlık, marka, fiyat, indirim ve 'Sepette indirim' kampanyası. `url` ya da `product_id` ile çağrılır. | hepsi opsiyonel |
| product/reviews | n11'in o ürün için yayımladığı bütün yorumlar, sayfalı ve sıralı. Varsayılan `sort=newest`. | hepsi opsiyonel |
| category | Kategori sayfasını `url` ile gezin ('…/<slug>' ya da '…-c-<id>'), sayfalı ve sıralanabilir. | url |
| seller | Mağaza profili ve ürünleri; mağaza takma adı ya da mağaza adresi ile. | seller |
| resolve | n11 kısa linkini (sl.n11.com/n/<token>) gerçek n11.com adresine çevirir ve türünü söyler. Elinizde paylaşılmış kısa link varsa ilk adım budur. | hepsi opsiyonel |
Her çağrı kredi ile ücretlendirilir. Başarısız ve engellenen çağrılar ücretsizdir.
Çalışan örnek
Aramadan product_id alın, detayı okuyun. Kampanyalı fiyat ile liste fiyatı ayrı alanlarda gelir; ürün karşılaştırması yapıyorsanız hangisini kullandığınıza dikkat edin, ikisi aynı şey değil.
curl -X POST https://api.reefapi.com/n11/v1/search \
-H "x-api-key: ANAHTARINIZ" \
-H "content-type: application/json" \
-d '{"query": "kulaklık", "page": 1}'{
"ok": true,
"data": {
"results": [
{
"product_id": "...",
"title": "...",
"brand": "...",
"price": 1299.0,
"rating": 4.5
}
]
},
"meta": { "record_count": 28, "cache_hit": false, "mode": "live" }
}Kendi n11 scriptinizi yazmak yerine
n11 için script yazmak zor değil, zaten çoğu kişi oradan başlıyor. Asıl maliyet sonradan çıkıyor: kategori yolları değişiyor, kısa linkler araya giriyor, yorum sayfalaması sıra değiştirince topladığınız veri sessizce eksiliyor.
Burada o işler bizde: rota değişirse motoru biz düzeltiriz, engellenme olursa açık hata kodu döner ve ücret alınmaz. Kısa link çözümleme ayrı bir uç olarak zaten var.
Tek seferlik küçük bir çıkarım için kendi scriptiniz daha ucuz. Sürekli çalışacak bir şey kuruyorsanız hesap tersine döner.
Sınırlar ve dürüst notlar
- Satıcı hesabı gerekmez, ama bu n11'in resmi API'si değildir ve onunla bir ortaklığımız yoktur.
- Kategori ucu id değil `url` ister; kaynak kategori sayfasını adresiyle yayımlıyor.
- Kampanyalı fiyat ile normal fiyat ayrı alanlardır. Kampanya yoksa alan null gelir, normal fiyat kampanyalı gibi gösterilmez.
- Her çağrı canlıdır; önbellekten yanıt dönmez.