Teknosa API: teknosa.com'da ürün, fiyat ve satıcı karşılaştırma verisi

teknosa.com yalnız Teknosa'nın değil, sitede mağaza açmış satıcıların da vitrini: 26 Ekim'de 'robot süpürge' diye arandığında ilk sayfadaki satırların hiçbirinde satıcı Teknosa değildi. Bu API o vitrini okur: ürün kodu, TL fiyat, üstü çizili fiyat, yalnız TeknoClub üyelerine gösterilen fiyat, satış kutusundaki mağaza ve aynı ürünü satan diğer mağazaların teklifleri, puan, barkod ve kategori. Teknosa'da mağaza açıp ürün yükleyen satıcıların kullandığı entegrasyonun yerine geçmez; sipariş, stok güncelleme ya da ilan yönetimi yok, yalnız müşteri tarafında görünen canlı ürün verisi var.

Çalışan örnek

Satış kutusunda Teknosa değil bir pazaryeri mağazası var (`is_teknosa: false`) ve ürün 19 999 TL. Aynı robot süpürgeyi iki mağaza daha satıyor, biri 21 249 TL'ye, diğeri 29 999 TL'ye; ikisi de `other_offers` içinde, kargoya veriliş süreleriyle. Ürün karşılaştırması yapıyorsanız tek bir `price` alanı yetmez: aynı ürün kodunun arkasında üç ayrı fiyat var ve hangisinin öne çıkacağına site karar veriyor. Belirli bir mağazanın fiyatını takip etmek için o teklifin `seller_id_param` değerini `seller_id` olarak gönderin.

curl -X POST https://api.reefapi.com/teknosa/v1/product/detail \
  -H "x-api-key: API_ANAHTARINIZ" \
  -H "content-type: application/json" \
  -d '{"product_id": "100000053862"}'

{
  "ok": true,
  "data": {
    "product": {
      "product_id": "100000053862",
      "title": "Dreame L10S Plus Robot Süpürge",
      "brand": "Dreame",
      "price": 19999,
      "currency": "TRY",
      "was_price": null,
      "member_price": null,
      "schema_org_price": 19999,
      "seller": { "name": "...", "shop_id": "3405", "is_teknosa": false, "badges": ["Başarılı Satıcı", "Hızlı Satıcı"] },
      "other_offers": [
        {
          "seller": { "name": "...", "shop_id": "3841", "is_teknosa": false, "badges": ["Hızlı Satıcı"] },
          "price": 21249,
          "currency": "TRY",
          "dispatch": { "min_business_days": 1, "max_business_days": 3, "text": "1-3 iş günü içinde kargoda" },
          "seller_id_param": "3841"
        },
        {
          "seller": { "name": "...", "shop_id": "5341", "is_teknosa": false, "badges": [] },
          "price": 29999,
          "currency": "TRY",
          "seller_id_param": "5341",
          ...
        }
      ],
      "availability": "in_stock",
      "rating": 5,
      "review_count": 2,
      "rating_breakdown": { "1": 0, "2": 0, "3": 0, "4": 0, "5": 2 },
      "category_path": ["Elektrikli Ev Aletleri", "Elektrikli Süpürge", "Robot Süpürge"],
      "barcode": "6976233674261",
      "favorites_count": 50,
      "specifications": [
        { "name": "Su Tankı Kapasitesi", "value": "0,2 - 0,49", "unit": "L" },
        { "name": "Gürültü Seviyesi", "value": "72 dB", "unit": null },
        ...
      ],
      ...
    }
  }
}

Sınırlar ve dürüst notlar

• Teknosa'dan bağımsız çalışır: bu API'yi Teknosa yayımlamadı, Teknosa'yla bir sözleşme ya da ortaklığımız da bulunmuyor.
• `in_stock` yalnız Teknosa'nın kendi depo işaretini yansıtır; pazaryeri satırlarında çoğunlukla null gelir ('robot süpürge' ilk sayfasında 20 satırın 19'unda). null 'stokta yok' anlamına gelmez; satılabilirlik için detaydaki `availability` alanına bakın.
• TeknoClub fiyatı (`member_price`) yalnız Teknosa bir ürüne üye fiyatı koyduğunda dolar. 26 Ekim'deki iki aramanın 40 satırında hiç yoktu; motor kurulurken ölçülen 445 arama satırının 11'inde vardı.
• Renk ve kapasite varyantları sayfada yayımlanmıyor, `variants` null gelir; her renk aramada ayrı bir ürün kodudur.
• Arama kelimeyi geniş yorumluyor: 'robot süpürge' sonuçlarında cam temizleme ve havuz temizleme robotları da vardı. Yalnız süpürge istiyorsanız `category_path` ile süzün ya da aramayı `category` ile yapın.
• Taksit tablosu, kampanya koşulları ve mağaza vitrin sayfaları için ayrı uç yok; detaydaki `campaigns` yalnız ürün sayfasındaki kampanya metnini taşır ve fiyattan düşülmez.
• Site bakımdayken (24 Eylül'deki gibi) çağrı hata ile döner ve ücretlendirilmez; o süre boyunca veri alınamaz.
• Her uçta çağrı başına 1 kredi düşer.