temsor API

Tek anahtar.
Tüm uçlar.

Tek anahtar ve tek yanıt zarfı arkasında büyüyen, küçük ve kesin API’ler kataloğu. Bir kez entegre edin — her yeni yetenek yeni bir tedarikçi değil, bir yol daha.

Katalogda bugün: Türkçe adres ve e-Fatura ayrıştırma, kimlik numarası doğrulama, iş günü hesabı, kur tarihçesi. Sırada: yaptırım ve PEP taraması, IBAN ve e-posta doğrulama.

  • Bu sayfadaki her ucu hesap açmadan deneyebilirsiniz.
  • Deterministik uçlar önbellekten tek haneli milisaniyede yanıtlar.
  • Her yanıt bir fiş taşır: harcanan kredi, önbellek durumu, süre.
POST/v1/tr/address/parse
{
  "address": "Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.
7uç nokta
biriken veri noktası
zaman serisi
ortanca yanıt

Neden var

Düşman girdi için tasarlandı

Türkçe adres "Cd." de olur "Cad." da "Caddesi" de; daire numarası bina numarasına yapışık gelir. Genel ayrıştırıcılar yarısını sessizce düşürür. Bu, yerleştiremediğini size söyler.

Tarihçe sonradan üretilemez

Kur arşivi her iş günü büyüyor ve her nokta kaynak URL’i ile içerik özetini saklıyor. Rakip bugünün bültenini okuyabilir — geçen çeyreği üretemez.

Yalnız yapılan işe ödersiniz

Tekrarlanan girdi önbellekten gelir, sıfır kredi yakar. Bir yanıt kendi şemasına uymazsa çağrı otomatik iade edilir.

Uç noktalarparametreleri görmek ve canlı çağırmak için satırı açın

Uyum1

/v1/sanctions/screen Yaptırım ve PEP Taraması 5 kredi

Bir ismi ABD OFAC, BM Güvenlik Konseyi ve AB konsolide yaptırım listelerinde, harf çevrimine duyarlı bulanık eşleştirmeyle tarar.

Kiril ve Arap harfli isimler Latin harfe çevrilir, unvan ve şirket ekleri ayıklanır, bilinen yazım aileleri birleştirilir — "Abd al-Rahman", "Abdul Rahman" ve "Abdulrahman" aynı kayda ulaşır. Her isabet kendini açıklar: hangi isim eşleşti, kaynak onu zayıf takma ad olarak mı işaretlemiş, doğum yılı ve ülke nasıl karşılaştırıldı. Elinizde varsa `birthYear` verin; yanlış eşleşmelerin çoğunu o eler. `asOf` listelerin geçmiş bir tarihteki hâline göre tarar — denetçinin asıl sorduğu sorudur; kapsam arşivimizin başladığı tarihle sınırlıdır ve `coverage` içinde bildirilir.

Parametreler

name* string Name to screen — person or organisation.
type "any" | "individual" | "entity" | "vessel" | "aircraft" Restrict to one subject type. Narrowing this removes most false positives. varsayılan "any"
birthYear integer Known birth year. The single strongest false-positive filter available.
country string Known country or nationality.
sources "OFAC_SDN" | "UN" | "EU"[] Defaults to all lists.
minScore number Score floor. 0.92+ reads as a match, 0.80+ as possible. varsayılan 0.75
limit integer varsayılan 10
asOf string Screen against the lists as they stood on this date. Limited by when our archive begins.
POST/v1/sanctions/screen
{
  "name": "Saddam Hussein"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Zaman Serisi1

/v1/series/history Zaman Serisi Tarihçesi 2 kredi

Biriktirilen kamu verisi serilerinin tarihçesini, değişim istatistikleriyle ve kaynak kanıtıyla döndürür.

Şu an beslenen seriler: TCMB günlük döviz kurları (`tcmb.usd`, `tcmb.eur`, …). Boş `seriesId` ile katalog listelenir. `fillGaps` hafta sonu/tatil boşluklarını son değerle doldurur; `includeEvidence` her nokta için kaynak URL ve içerik özetini ekler.

Parametreler

seriesId string Seri kimliği, ör. `tcmb.usd`. Boş bırakılırsa katalog döner.
from string Başlangıç tarihi (dahil).
to string Bitiş tarihi (dahil).
limit integer varsayılan 365
fillGaps boolean varsayılan false
includeEvidence boolean Her nokta için kaynak URL ve içerik özetini döndürür. varsayılan false
POST/v1/series/history
{}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Adres1

/v1/tr/address/parse Türkçe Adres Ayrıştırma deterministik 1 kredi

Serbest metin Türkçe adresi mahalle, cadde/sokak, bina, kat, daire, ilçe, il ve posta koduna ayırır.

Kısaltma kaosunu (Mah./Mh., Cd./Cad., Sk./Sok., No:12/5, K:3 D:7) tek elden çözer; posta koduyla ili çapraz doğrular, ilçe yazım hatalarını sözlüğe göre düzeltir ve her alan için güven skoru üretir. Ayrıştırılamayan parçalar `unparsed` içinde açıkça bildirilir — sessizce veri kaybı yoktur.

Parametreler

address* string Serbest metin adres.
defaultProvince string Adreste il geçmiyorsa varsayılacak il.
POST/v1/tr/address/parse
{
  "address": "Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Takvim1

/v1/tr/business-days Türkiye İş Günü Hesabı deterministik 1 kredi

Resmî ve dinî tatilleri (arife yarım günleri dahil) hesaba katarak iş günü ekler veya iki tarih arasını sayar.

Ramazan ve Kurban bayramları hicri takvime bağlı olduğu için ilan edilmiş tarih tablosundan okunur; henüz resmî ilanı yapılmamış yıllar `confirmed:false` ile tahmini olarak işaretlenir. Termin, SLA, vade ve kargo süresi hesaplayan her sistemin ihtiyacı.

Parametreler

start* string Başlangıç tarihi (YYYY-AA-GG).
addDays integer Bu kadar İŞ GÜNÜ ekle/çıkar.
end string Verilirse aradaki iş günü sayılır.
countHalfDaysAsWork boolean Arife yarım günleri iş günü sayılsın mı? varsayılan true
POST/v1/tr/business-days
{
  "start": "2026-03-16",
  "addDays": 10
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Finans2

/v1/tr/invoice/parse e-Fatura (UBL-TR) Ayrıştırma deterministik 3 kredi

UBL-TR e-Fatura/e-Arşiv XML belgesini kalem, taraf, vergi ve toplam bilgileriyle temiz JSON'a çevirir.

Ad alanı öneki (cbc:, cac:, ns0:) ne olursa olsun çalışır; tek kalemli belgelerde dizi normalleştirmesi yapar, tutar tutarsızlıklarını `warnings` ile bildirir. Muhasebe, ön muhasebe ve gider yönetimi yazılımlarının en çok vakit kaybettiği iş.

Parametreler

xml* string UBL-TR e-Fatura / e-Arşiv XML içeriği.
POST/v1/tr/invoice/parse
{
  "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Invoice xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\"\n         xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\"\n         xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\">\n  <cbc:UBLVersionID>2.1</cbc:UBLVersionID>\n  <cbc:ProfileID>TEMELFATURA</cbc:ProfileID>\n  <cbc:ID>ABC2026000000123</cbc:ID>\n  <cbc:UUID>3f2504e0-4f89-11d3-9a0c-0305e82c3301</cbc:UUID>\n  <cbc:IssueDate>2026-07-20</cbc:IssueDate>\n  <cbc:InvoiceTypeCode>SATIS</cbc:InvoiceTypeCode>\n  <cbc:DocumentCurrencyCode>TRY</cbc:DocumentCurrencyCode>\n  <cac:AccountingSupplierParty><cac:Party>\n    <cac:PartyIdentification><cbc:ID schemeID=\"VKN\">1234567890</cbc:ID></cac:PartyIdentification>\n    <cac:PartyName><cbc:Name>Örnek Yazılım A.Ş.</cbc:Name></cac:PartyName>\n    <cac:PostalAddress><cbc:StreetName>Moda Cad.</cbc:StreetName><cbc:BuildingNumber>12</cbc:BuildingNumber>\n      <cbc:CitySubdivisionName>Kadıköy</cbc:CitySubdivisionName><cbc:CityName>İstanbul</cbc:CityName></cac:PostalAddress>\n    <cac:PartyTaxScheme><cac:TaxScheme><cbc:Name>Kadıköy</cbc:Name></cac:TaxScheme></cac:PartyTaxScheme>\n  </cac:Party></cac:AccountingSupplierParty>\n  <cac:AccountingCustomerParty><cac:Party>\n    <cac:PartyIdentification><cbc:ID schemeID=\"VKN\">9876543210</cbc:ID></cac:PartyIdentification>\n    <cac:PartyName><cbc:Name>Alıcı Ticaret Ltd. Şti.</cbc:Name></cac:PartyName>\n  </cac:Party></cac:AccountingCustomerParty>\n  <cac:TaxTotal><cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount>\n    <cac:TaxSubtotal><cbc:TaxableAmount currencyID=\"TRY\">1000.00</cbc:TaxableAmount>\n      <cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount><cbc:Percent>20</cbc:Percent>\n      <cac:TaxCategory><cac:TaxScheme><cbc:Name>KDV</cbc:Name><cbc:TaxTypeCode>0015</cbc:TaxTypeCode></cac:TaxScheme></cac:TaxCategory>\n    </cac:TaxSubtotal></cac:TaxTotal>\n  <cac:LegalMonetaryTotal>\n    <cbc:LineExtensionAmount currencyID=\"TRY\">1000.00</cbc:LineExtensionAmount>\n    <cbc:TaxExclusiveAmount currencyID=\"TRY\">1000.00</cbc:TaxExclusiveAmount>\n    <cbc:TaxInclusiveAmount currencyID=\"TRY\">1200.00</cbc:TaxInclusiveAmount>\n    <cbc:PayableAmount currencyID=\"TRY\">1200.00</cbc:PayableAmount>\n  </cac:LegalMonetaryTotal>\n  <cac:InvoiceLine>\n    <cbc:ID>1</cbc:ID>\n    <cbc:InvoicedQuantity unitCode=\"C62\">10</cbc:InvoicedQuantity>\n    <cbc:LineExtensionAmount currencyID=\"TRY\">1000.00</cbc:LineExtensionAmount>\n    <cac:TaxTotal><cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount>\n      <cac:TaxSubtotal><cbc:TaxableAmount currencyID=\"TRY\">1000.00</cbc:TaxableAmount>\n        <cbc:TaxAmount currencyID=\"TRY\">200.00</cbc:TaxAmount><cbc:Percent>20</cbc:Percent>\n        <cac:TaxCategory><cac:TaxScheme><cbc:Name>KDV</cbc:Name><cbc:TaxTypeCode>0015</cbc:TaxTypeCode></cac:TaxScheme></cac:TaxCategory>\n      </cac:TaxSubtotal></cac:TaxTotal>\n    <cac:Item><cbc:Name>Yıllık Lisans</cbc:Name></cac:Item>\n    <cac:Price><cbc:PriceAmount currencyID=\"TRY\">100.00</cbc:PriceAmount></cac:Price>\n  </cac:InvoiceLine>\n</Invoice>"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.
/v1/tr/money/to-words Tutarı Türkçe Yazıya Çevirme deterministik 1 kredi

Para tutarını fatura/çek/senet metinlerinde kullanılan Türkçe yazıya çevirir.

Türkçeye özgü kuralları uygular: "bir bin" değil "bin"; kuruş kısmı ayrı okunur; "1.234,56" ile "1,234.56" yazımlarını otomatik ayırt eder. e-Fatura, çek ve senet üreten her sistemin zorunlu alanı — ve hazır bir API'si yok.

Parametreler

amount* string | number Tutar. "1.234,56" ve 1234.56 biçimlerinin ikisi de kabul edilir.
currency "TRY" | "USD" | "EUR" | "GBP" varsayılan "TRY"
style "lower" | "title" | "upper" Çıktı harf biçimi. varsayılan "lower"
wrapHash boolean varsayılan false
POST/v1/tr/money/to-words
{
  "amount": "1.234,56"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Doğrulama1

/v1/tr/validate Türkiye Kimlik & Numara Doğrulama deterministik 1 kredi

TCKN, VKN, IBAN, plaka, IMEI ve barkod doğrulaması — tek uç noktada, otomatik tip tespitiyle.

Yalnız "geçerli mi" demez: IBAN'da bankayı, plakada ili, barkodda GS1 ülke önekini de çözer. Tamamen yerel hesaplama — dış servis çağrılmaz, gecikme mikrosaniye seviyesindedir.

Parametreler

value* string Doğrulanacak değer.
type "auto" | "tckn" | "vkn" | "iban" | "plate" | "imei" | "gtin" Belirtilmezse biçimden otomatik tespit edilir. varsayılan "auto"
POST/v1/tr/validate
{
  "value": "TR33 0006 1005 1978 6457 8413 26"
}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Fiyatlandırmatek anahtar tüm uçları kapsar

Free
Ücretsiz
kredi
2,000
Hız sınırı
2/s
Starter
$19/ay
kredi
50,000
Hız sınırı
10/s
en çok seçilen
Pro
$79/ay
kredi
300,000
Hız sınırı
30/s
Scale
$299/ay
kredi
2,000,000
Hız sınırı
100/s

Kredi çağrı başına düşer, önbellekten gelen yanıt ücretsizdir. Anahtarsız istekler IP başına dar bir demo kotasıyla çalışır; kaydolmadan değerlendirebilirsiniz.

Hızlı başlangıç

cURL

curl -s https://api.temsor.com/v1/tr/address/parse \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{"address":"Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/tr/address/parse", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({"address":"Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/tr/address/parse",
    headers={"x-api-key": KEY},
    json={"address":"Caferağa Mah. Moda Cd. No:12/5 K:3 34710 Kadıköy/İstanbul"})
data = r.json()["data"]