Toplu değerleme API'si

Elinizdeki araç listesini gönderin, her biri için ilan fiyatlarına dayalı bir değer alın. Rakam, o araca gerçekten benzeyen ilanlardan hesaplanır; sabit bir listeden değil. Her değerle birlikte, dayandığı ilanların hangi tarihte görüldüğü de döner.

Rakamın arkasında ne var

son 3 günün tarama verisi

18.566

son 3 günde görülen ilan

231

kendi fiyat endeksi olan model

16

taranan ilan kaynağı

sahibinden.comarabam.comOtokoç 2.ElDoğuş DODFord 2.ElToyota 2.ElBorusan NextVavaCarsotosorotoplusotoshopssensatsatariz.comrenewKavakilan.gov.tr (icra)

Kaynağından kalkmış ilanlar da emsal sayılır; ilan ne kadar önce görüldüyse hesaptaki ağırlığı o kadar azalır. Yöntemin tamamı Veri ve yöntem sayfasında açıktır. API, sitede gördüğünüz rakamın aynısını döndürür, ayrı bir model çalıştırmaz.

Sapma ölçümümüzü marka kırılımıyla CSV indirin → değerlememizin piyasa fiyatından ne kadar saptığını kendi tarafınızda doğrulayın.

Örnek istek

Tek istekte en fazla 50 araç. Kimlik doğrulama Authorization: Bearer başlığıyla.

curl -X POST https://aracendeks.com/api/v1/degerleme \
  -H "Authorization: Bearer <anahtarınız>" \
  -H "Content-Type: application/json" \
  -d '{
    "araclar": [
      { "ref": "FILO-1043", "modelId": 55, "yil": 2019,
        "km": 85000, "yakit": "Dizel", "vites": "Otomatik",
        "hasar": "hasarsiz_boyasiz", "trim": "1.6 TDI Highline" }
    ]
  }'

Örnek yanıt

{
  "sonuclar": [
    {
      "ref": "FILO-1043",
      "deger": 2822040,
      "aralik": { "alt": 2729097, "ust": 2958638 },
      "emsalSayisi": 43,
      "normalizeEmsal": 0,
      "guven": 0.79,
      "emsalKalite": "birebir",
      "tahmini": false,
      "hasarVarsayimi": false,
      "hasarDuzeltmeli": false,
      "veri_tarihi": "2026-10-10T08:12:00.000Z",
      "tazelik": { "oran": 0.86, "taze_n": 37, "toplam_n": 43, "durum": "taze" },
      "kaynak_kesintisi": []
    }
  ],
  "kullanim": { "istenen": 1, "faturalanan": 1, "kalanKota": 499 }
}

aralik emsallerin alt ve üst çeyreğidir, yani piyasanın o araç için gerçekten hareket ettiği bant. guven, emsal sayısı ve benzerliğinden türer; düşükse rakama temkinli yaklaşın. tahmini: true ise birebir emsal yetmemiş, değer modelin daha geniş havuzundan düzeltmelerle hesaplanmıştır. hasarVarsayimi: true ise hasar bilgisi gönderilmediği için araç hasarsız varsayılmıştır; gerçek hasar farklıysa değer değişir. hasarDuzeltmeli: true ise aracın hasar sınıfından yeterli emsal yoktur; değer, diğer hasar sınıflarındaki gerçek ilanların ölçülmüş hasar farkıyla bu sınıfa düzeltilmesiyle hesaplanmıştır. Bu durumda tahmini de true döner.

veri_tarihi değere giren emsallerin ortanca son görülme anıdır; değer o tarihteki ilanlara dayanır. tazelik emsallerin kaçının son 72 saatte görüldüğünü yazar: taze en az 8 emsal ve %70'i taze, kismi oran yetmiyor ama en az 8 taze emsal var, bayat ikisi de yok. kaynak_kesintisi şu an taranamayan kaynakları ve kesintinin başladığı anı listeler. Tarihi bilinmeyen emsallerde veri_tarihi ve tazelik null döner.

Alanlar

curl -H "Authorization: Bearer <anahtarınız>" \
  "https://aracendeks.com/api/v1/modeller?q=passat"

Rakam veremediğimizde

Bir araç için yeterli emsal yoksa deger: null ve bir sebep döner. Tahmin uydurmayız ve o araç kotanızdan düşmez. Bir satırın sorunu diğerlerini etkilemez; istek yine bütün olarak başarılı döner.

• emsal_yetersizAynı model, yıl, yakıt ve vitesten yeterli sayıda ilan yok. Rakam üretmeyiz.
• model_bulunamadiGönderilen modelId kayıtlarımızda yok. Diğer araçlar işlenmeye devam eder.
• eksik_girdiZorunlu alanlardan biri eksik ya da tanınmadı; hangileri olduğu eksikAlanlar alanında döner. Değeri doğrudan etkileyen bilgi olmadan rakam üretmeyiz.
• gecersiz_girdiYıl veya kilometre okunamadı ya da makul aralığın dışında.
• hesaplanamadiBeklenmedik bir durum; o satır atlandı, istek bütün olarak başarılı döner.
• zaman_asimiİstek süre sınırına yaklaştı, bu satır hesaplanmadan kapatıldı. Aynı aracı tekrar gönderebilirsiniz.

Sınırlar ve hata kodları

Ağ hatasında isteği güvenle tekrarlamak için Idempotency-Key başlığı gönderin; aynı anahtarla gelen tekrar yeniden faturalanmaz, ilk yanıt aynen döner.

• 401 gecersiz_anahtarAnahtar yanlış, pasif ya da deneme süresi dolmuş.
• 400 cok_fazla_aracTek istekte en fazla 50 araç.
• 413 govde_cok_buyukİstek gövdesi 256 KB'ı aşamaz.
• 429 eszamanli_istek_siniriAynı anahtarla aynı anda en fazla 2 istek işlenir. Retry-After başlığındaki süre kadar bekleyip tekrar gönderin.
• 429 kota_asildiAylık kotanız doldu. Yalnız değer dönen araçlar kotadan düşer.
• 429 gunluk_istek_siniriBir günde en fazla 3.000 araç gönderilebilir (sonuç dönsün dönmesin). Hatalı döngülere karşı koruma; normal kullanımda karşılaşılmaz.
• 409 islem_devam_ediyorAynı Idempotency-Key ile gönderilen ilk istek hâlâ işleniyor. Birkaç saniye sonra tekrar deneyin; ilk isteğin yanıtı aynen döner.

Teklif alın

Aylık kaç araç değerleyeceğinizi ve ne için kullanacağınızı yazmanız yeterli. Deneme anahtarıyla kendi listenizde sonuçları görebilirsiniz.