Maaş Hesaplama API (döviz ve enflasyon)
Maaşın döviz ve enflasyon karşısındaki değişimini tek istekte hesaplayın.
/v1/hesapla/maas-doviz maaşı istediğiniz paralara (anlık Kapalıçarşı satış, ECB referans ya da TCMB döviz satış kuru) çevirir; aylık, yıllık, haftalık, günlük ve saatlik karşılıkları ve asgari ücretin kaç katı olduğunu verir.
/v1/hesapla/maas-gecmis geçmiş bir tarihteki maaşın o gün kaç dolar ettiğini, bugün aynı dolar karşılığı ve aynı alım gücü (TÜFE) için kaç TL gerektiğini söyler. /maas-enflasyon maaşı iki ay arasındaki TÜFE ile günceller ve bugünkü maaşla reel değişimi, /maas-zam zam oranını ve enflasyona göre reel zammı, /maas-karsilastir iki tarihteki maaşı nominal, reel, döviz ve asgari ücret katıyla karşılaştırır.
Kur geçmişi TCMB döviz satış kurudur (5 yıl), enflasyon TÜFE endeksidir (2005'ten; son açıklanan ay kullanılır). Brütten nete hesap için /v1/vergi/maas.
Hızlı başlangıç
Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al).
Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.
<?php
$ch = curl_init('https://api.veriapi.pro/v1/hesapla/maas-doviz?maas=50000&hedef=USD,EUR');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/hesapla/maas-doviz?maas=50000&hedef=USD,EUR", {
headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests
r = requests.get("https://api.veriapi.pro/v1/hesapla/maas-doviz?maas=50000&hedef=USD,EUR",
headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \ "https://api.veriapi.pro/v1/hesapla/maas-doviz?maas=50000&hedef=USD,EUR"
Örnek yanıt
GET https://api.veriapi.pro/v1/hesapla/maas-doviz?maas=50000&hedef=USD,EUR — gerçek veriyle; listeler kısaltıldı.
{
"veri": {
"maas": 50000.0,
"para": "TRY",
"donem": "aylik",
"kaynak_para": {
"aylik": 50000.0,
"yillik": 600000.0,
"haftalik": 11538.46,
"gunluk": 1666.67,
"saatlik": 222.22
},
"tl_aylik": 50000.0,
"karsiliklar": [
{
"para": "USD",
"kur": 0.019986,
"ters_kur": 50.036,
"aylik": 999.28,
"yillik": 11991.37,
"haftalik": 230.6,
"gunluk": 33.31,
"saatlik": 4.44
},
{
"para": "EUR",
"kur": 0.017896,
"ters_kur": 55.879,
"aylik": 894.79,
"yillik": 10737.49,
"haftalik": 206.49,
"gunluk": 29.83,
"saatlik": 3.98
}
],
"asgari_ucret_kati": {
"net": 1.78,
"brut": 1.51
},
"kur_turu": "Kapalıçarşı satış kuru (anlık)",
"kur_tarihi": "2026-11-03",
"kur_zamani": "2026-11-03T01:45:15",
"not": "Dönem çevirme: ay = 30 gün, 225 saat (haftada 45 saat), yıl = 52 hafta. Asgari ücret katı TL karşılığa göre."
},
"kaynak": [
{
"kod": "biquote",
"ad": "biquote.io",
"lisans": "Yazılı yeniden dağıtım izniyle (11.2026); fiyatlar yol gösterici niteliktedir",
"atif": "Piyasa verisi: biquote.io (Kapalıçarşı fiyatları Harem Altın / Hakan Döviz; atıf zorunlu değildir)",
"url": "https://biquote.io/"
},
{
"kod": "ecb",
"ad": "Avrupa Merkez Bankası (ECB)",
"lisans": "Kaynak gösterilerek serbest; ücretsiz olarak ECB sitesinde de yayımlanır",
"atif": "Kaynak: Avrupa Merkez Bankası euro referans kurları (çapraz kurlar VeriApi.Pro tarafından hesaplanmıştır)",
"url": "https://www.ecb.europa.eu/stats/exchange/eurofxref/html/index.en.html"
},
{
"kod": "mevzuat",
"ad": "Resmî Gazete / mevzuat",
"lisans": "FSEK m.31 (yayımlanmış mevzuat)",
"atif": "Kaynak: Resmî Gazete'de yayımlanan mevzuat (2429 sayılı Kanun, Gelir Vergisi Genel Tebliği, Asgari Ücret Tespit Komisyonu kararı vb.)",
"url": "https://www.resmigazete.gov.tr/"
},
"… 1 öğe daha"
],
"guncelleme": null,
"bayat": false
}
Uçlar ve parametreler
GET /v1/hesapla/maas-doviz
ücretli paket
1 birim
Maaşın dolar / euro / sterlin karşılığı (aylık, yıllık, saatlik)
| Parametre | Tür | Açıklama |
|---|---|---|
| maas* | sayı | Maaş tutarı |
| para | metin | Maaşın para birimi varsayılan: TRY |
| hedef | metin | Virgülle hedef paralar varsayılan: USD,EUR,GBP |
| donem | metin | Verilen tutarın dönemi varsayılan: aylik |
| kur | metin | anlik: Kapalıçarşı satış; referans: ECB; tcmb: TCMB döviz satış varsayılan: anlik |
GET /v1/hesapla/maas-gecmis
ücretli paket
1 birim
Geçmiş maaş: o gün kaç dolardı, bugün aynı alım gücü için kaç TL
| Parametre | Tür | Açıklama |
|---|---|---|
| maas* | sayı | Maaş tutarı |
| tarih* | metin | Maaşın alındığı tarih (YYYY-AA-GG) |
| para | metin | varsayılan: TRY |
| hedef | metin | varsayılan: USD |
GET /v1/hesapla/maas-enflasyon
ücretli paket
1 birim
Maaşı TÜFE'ye göre güncelle, reel değişim
| Parametre | Tür | Açıklama |
|---|---|---|
| maas* | sayı | Maaş tutarı |
| baslangic* | metin | YYYY-AA |
| bitis | metin | YYYY-AA (varsayılan son açıklanan ay) |
| guncel_maas | sayı | Bugünkü maaş (reel değişim için) |
GET /v1/hesapla/maas-zam
ücretli paket
1 birim
Zam oranı ve enflasyona göre reel zam
| Parametre | Tür | Açıklama |
|---|---|---|
| maas* | sayı | Maaş tutarı |
| zam_orani | sayı | Zam (%) |
| yeni_maas | sayı | ya da yeni maaş |
| enflasyon | sayı | Karşılaştırılacak enflasyon (%); boşsa son yıllık TÜFE |
GET /v1/hesapla/maas-karsilastir
ücretli paket
1 birim
İki tarihteki maaşı karşılaştır: nominal, reel (TÜFE), döviz ve asgari ücret katı
| Parametre | Tür | Açıklama |
|---|---|---|
| maas1* | sayı | İlk maaş |
| tarih1* | metin | |
| maas2* | sayı | Sonraki maaş |
| tarih2 | metin | Varsayılan bugün |
| doviz | metin | Virgülle; boş = döviz karşılaştırması yok varsayılan: USD,EUR |
GET /v1/hesapla/maas-donem
ücretli paket
1 birim
Maaşı dönemler arasında çevir (aylık ↔ yıllık ↔ günlük ↔ saatlik)
| Parametre | Tür | Açıklama |
|---|---|---|
| maas* | sayı | Maaş tutarı |
| donem | metin | Verilen tutarın dönemi varsayılan: aylik |
| saat | sayı | Aylık çalışma saati varsayılan: 225 |
Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir.
Tüm parametreler: OpenAPI belgesi.
Nerelerde kullanılır?
- ✓İK portallarında zam ve reel ücret karşılaştırması
- ✓Haber sitelerinde 'maaşınız kaç dolar' aracı
- ✓Yurt dışı iş tekliflerini TL ile karşılaştırmak
Kaynak ve lisans
- biquote.io · Yazılı yeniden dağıtım izniyle (11.2026); fiyatlar yol gösterici niteliktedir · kaynak
Atıf: Piyasa verisi: biquote.io (Kapalıçarşı fiyatları Harem Altın / Hakan Döviz; atıf zorunlu değildir)
- TCMB EVDS ve TÜİK verisi (Turkpidya derlemesi) · Turkpidya yazılı izniyle (11.2026); TCMB / TÜİK verisi kaynak gösterilerek, ek ücret olarak yansıtılmaz · kaynak
Atıf: Kaynak: TÜİK, TCMB EVDS; değişim oranları endeksten hesaplanmıştır
- VeriApi.Pro hesaplaması · VeriApi.Pro
Atıf: VeriApi.Pro tarafından hesaplanmıştır
Her yanıtın kaynak alanı bu bilgiyi taşır; veriyi gösterdiğiniz yerde atıf metnini yazın.
Sık sorulan sorular
Maaş hesaplama uçları ücretsiz mi?
Hayır; /v1/hesapla altındaki hesaplayıcılar Başlangıç ve üstü paketlerdedir.
Hangi kur kullanılıyor?
kur=anlik Kapalıçarşı satış kuru (dakikada bir), kur=referans ECB, kur=tcmb TCMB döviz satış kurudur. Geçmiş tarihler için TCMB satış kuru kullanılır.
Enflasyon hangi ay için?
TÜFE aylık açıklandığı için hesap son açıklanan aya kadar yapılır; yanıtta ay belirtilir.
Bu sayfa şu aramalar için de: maaş kaç dolar hesaplama · dolar bazında maaş · enflasyona göre maaş hesaplama api · reel zam hesaplama