Ünvan ile Sorgulama

VKN'yi bilmeden şirket adıyla arama yapmanızı sağlar. 1.7 milyon kayıtlı şirket arasında akıllı eşleşme yapar, bulunan VKN ile Kurum'dan bilgileri çeker.

Nasıl Çalışır?

Siz: "UYUMSOFT" gönderirsiniz
   ↓
Sistem: 1.7M şirket arasında benzerlik araması yapar
   ↓
Eşleşme: Uyumsoft Bilgi Sistemleri... → VKN: 9000068418
   ↓
Kurum: VKN ile sorgulanır, şirket bilgisi alınır
   ↓
Size: Eşleşme + Kurum verisi birlikte döner

---

Genel Bilgi — POST /v1/search/title

Maliyet: Bakiye panelinizden görüntüleyebilirsiniz

İstek

{ "title": "UYUMSOFT" }

Kısmi isim veya tam ünvan gönderebilirsiniz:

{ "title": "UYUMSOFT KURUMSAL" }
{ "title": "PARK OTOMOTİV" }
{ "title": "Anadolu Uluaşım" }

Yanıt

{
  "success": true,
  "dusulen_bakiye": 2,
  "response_time_ms": 185,
  "matched": {
    "ad": "Uyumsoft Bilgi Sistemleri Ve Teknolojileri Ticaret Anonim Şirketi",
    "vkn": "9000068418",
    "score": 1.0
  },
  "alternatives": [
    {
      "ad": "KUYUMSOFT YAZILIM VE DANIŞMANLIK LİMİTED ŞİRKETİ",
      "vkn": "6010471984",
      "score": 0.7778
    }
  ],
  "data": {
    "Merkez": {
      "MersisNo": "...",
      "Unvani": "...",
      "Durumu": "Aktif",
      "Adres": "...",
      "...": "..."
    }
  }
}

data alanı, VKN genel sorgusunun tam yanıt yapısını içerir. → VKN Yanıt Yapısı

Alan Açıklamaları

Alan	Açıklama
matched.ad	Veritabanında bulunan şirket adı
matched.vkn	Eşleşen VKN — Kurum bu numara ile sorgulandı
matched.score	Benzerlik skoru: 0.0–1.0 (yüksek = daha iyi)
alternatives	Diğer olası eşleşmeler, score'a göre sıralı
data.Merkez	Kurum'dan dönen şirket bilgisi

Erişim Örneği

const result = await searchByTitle('UYUMSOFT')

console.log(result.matched.ad)      // "Uyumsoft Bilgi Sistemleri..."
console.log(result.matched.vkn)     // "9000068418"
console.log(result.matched.score)   // 1.0

const merkez = result.data.Merkez
console.log(merkez.Unvani)          // Şirket ünvanı
console.log(merkez.Durumu)          // "Aktif"
console.log(merkez.Adres)           // Adres

---

Detaylı Bilgi — POST /v1/search/title/detail

Maliyet: Bakiye panelinizden görüntüleyebilirsiniz

Aynı eşleşme mantığı, aynı istek formatı. data alanında detaylı şirket kartı döner: ortaklar, temsilciler, şubeler, NACE kodları vb.

{ "title": "UYUMSOFT" }

data alanı yapısı için → VKN Detaylı Yanıt Yapısı

---

Eşleşme Hassasiyeti

Gönderilen	Eşleşen
UYUMSOFT	Uyumsoft Bilgi Sistemleri...
PARK OTOMOTİV	PARK OTOMOTİV TUR.OTELCİLİK...
ANADOLU ULUAŞIM	ANADOLU ULUAŞIM A.Ş.
krank bilisim	KRANK BİLİŞİM TEKNOLOJİLERİ LTD.ŞTİ.

Büyük/küçük harf farkı gözetilmez.

Eşleşme Bulunamazsa

{
  "error": "Eslesen firma bulunamadi",
  "code": "NOT_FOUND"
}

HTTP 404 döner ve bakiye düşülmez.

Önemli Not

Ünvan araması 1.7 milyon e-fatura sistemine kayıtlı şirketi kapsar. Yeni kurulan veya e-fatura sistemine geçmemiş şirketler listede olmayabilir. Bu durumda VKN'yi bilerek /v1/search/vkn ile sorgulayın.