Maaş Hesaplama API (döviz ve enflasyon)

Maaşın döviz ve enflasyon karşısındaki değişimini tek istekte hesaplayın.

Ücretli paketlerde JSON · Türkçe6 uç Kaynak: biquote.io, TCMB EVDS ve TÜİK verisi (Turkpidya derlemesi), VeriApi.Pro hesaplaması

/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)

ParametreTürAçı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

ParametreTürAçı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

ParametreTürAçı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

ParametreTürAçı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ı

ParametreTürAçı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)

ParametreTürAçı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