API Dokümantasyonu
Web TÜFE verilerine REST API üzerinden erişin — Python, Excel, R veya herhangi bir araçla.
Genel Bakış
https://www.apiwebtufe.com/api/v1Kimlik Doğrulama
Gerekmiyor — herkese açık
Yanıt Formatı
JSON (UTF-8)
Güncelleme
Her ayın 24'ü (kesinleşme)
Endpoint Listesi
TÜFE (Manşet)
Ana Gruplar (12 Grup)
Harcama Grupları (13 Grup)
Özel Kapsamlı Göstergeler
PCE (Kişisel Tüketim Harcamaları)
Maddeler (~390 Ürün/Hizmet)
Diğer
Python Kullanımı
API'ye erişmek için requests kütüphanesi yeterlidir. Veri analizi için pandas kullanımı önerilir.
Kurulum
pip install requests pandas openpyxlHızlı Başlangıç
Aşağıdaki kod Web TÜFE yıllık değişim serisini çeker ve son 6 dönemi gösterir.
import requests
import pandas as pd
BASE = "https://www.apiwebtufe.com/api/v1"
# Web TÜFE yıllık değişim
r = requests.get(f"{BASE}/tufe/yearly")
df = pd.DataFrame(r.json())
df["date"] = pd.to_datetime(df["date"])
print(df.tail(6))Örnek Çıktı:
date value
12 2025-12-31 53.93
13 2026-01-31 34.69
14 2026-02-28 36.57
15 2026-03-31 35.07
16 2026-04-30 35.05
17 2026-05-31 33.16
TÜFE Verileri
import requests
import pandas as pd
BASE = "https://www.apiwebtufe.com/api/v1"
# Özet verisi — son değerler
ozet = requests.get(f"{BASE}/tufe").json()
print(f"Tarih : {ozet['latest_date']}")
print(f"Yıllık : %{ozet['latest_yearly']:.2f}")
print(f"Aylık : %{ozet['latest_monthly']:.2f}")
# Yıllık değişim zaman serisi
yillik = pd.DataFrame(requests.get(f"{BASE}/tufe/yearly").json())
yillik["date"] = pd.to_datetime(yillik["date"])
yillik = yillik.set_index("date")
# Aylık değişim zaman serisi
aylik = pd.DataFrame(requests.get(f"{BASE}/tufe/monthly").json())
aylik["date"] = pd.to_datetime(aylik["date"])
# TÜİK karşılaştırması
tuik = pd.DataFrame(requests.get(f"{BASE}/tufe/tuik-comparison").json())
print(tuik.tail())Ana Gruplar ve Katkı Payları
/gruplar/yearly her satır bir dönem, her sütun bir ana grup döndürür. Grup sayısı 12'dir (Web TÜFE dahil).
import requests
import pandas as pd
BASE = "https://www.apiwebtufe.com/api/v1"
# Ana gruplar yıllık değişim
r = requests.get(f"{BASE}/gruplar/yearly")
df = pd.DataFrame(r.json())
df["date"] = pd.to_datetime(df["date"])
# Son dönem yıllık değişimler
son = df.set_index("date").iloc[-1]
print(son.sort_values(ascending=False))
# Katkı payları (manşet enflasyona katkı, puan)
katki = pd.DataFrame(requests.get(f"{BASE}/gruplar/katki").json())
katki["date"] = pd.to_datetime(katki["date"])
print(katki.tail())
# Harcama grupları (13 grup) aylık değişim
harcama = pd.DataFrame(requests.get(f"{BASE}/harcama-gruplari/monthly").json())
harcama["date"] = pd.to_datetime(harcama["date"])
print(harcama.columns.tolist())PCE Verisi ile Karşılaştırma
import requests
import pandas as pd
BASE = "https://www.apiwebtufe.com/api/v1"
# PCE yıllık ve aylık değişim
pce_y = pd.DataFrame(requests.get(f"{BASE}/pce/yearly").json())
pce_m = pd.DataFrame(requests.get(f"{BASE}/pce/monthly").json())
# Web TÜFE ile birleştir
tufe_y = pd.DataFrame(requests.get(f"{BASE}/tufe/yearly").json())
merged = pce_y.merge(tufe_y, on="date", suffixes=("_pce", "_tufe"))
merged["fark"] = merged["value_pce"] - merged["value_tufe"]
print(merged[["date", "value_pce", "value_tufe", "fark"]].tail(12))
# PCE grupları ağırlık
agirlik = pd.DataFrame(requests.get(f"{BASE}/pce/gruplar/agirlik").json())
print(agirlik.tail())Madde Bazında Sorgulama
import requests
import pandas as pd
BASE = "https://www.apiwebtufe.com/api/v1"
# Tüm madde adlarını listele (~390 madde)
isimler = requests.get(f"{BASE}/maddeler/names").json()
print(f"Toplam madde: {len(isimler)}")
print(isimler[:10])
# Belirli bir maddeyi sorgula (arama ile)
r = requests.get(f"{BASE}/maddeler/monthly", params={"search": "ekmek"})
df = pd.DataFrame(r.json())
df["date"] = pd.to_datetime(df["date"])
print(df.tail())Toplu İndirme — Excel'e Aktar
Tüm temel serileri tek seferde çekip çok sayfalı bir Excel dosyasına kaydedin.
import requests
import pandas as pd
BASE = "https://www.apiwebtufe.com/api/v1"
endpoints = {
"tufe_yillik": "/tufe/yearly",
"tufe_aylik": "/tufe/monthly",
"gruplar_yillik": "/gruplar/yearly",
"gruplar_aylik": "/gruplar/monthly",
"harcama_yillik": "/harcama-gruplari/yearly",
"ozel_yillik": "/ozel-gostergeler/yearly",
"pce_yillik": "/pce/yearly",
}
# Excel'e yaz (her endpoint ayrı sheet)
with pd.ExcelWriter("webtufe_veriler.xlsx", engine="openpyxl") as writer:
for sheet, path in endpoints.items():
df = pd.DataFrame(requests.get(f"{BASE}{path}").json())
df["date"] = pd.to_datetime(df["date"])
df.to_excel(writer, sheet_name=sheet, index=False)
print(f" ✓ {sheet} ({len(df)} satır)")
print("webtufe_veriler.xlsx kaydedildi.")Excel — Power Query ile Veri Çekme
Microsoft Excel'in Power Query özelliği JSON API'lerini doğrudan çalışma sayfasına aktarabilir. Aşağıdaki adımlar Excel 2016 ve sonrası için geçerlidir.
Power Query'yi açın
Excel'de şeritteki "Veri" sekmesine tıklayın. "Veri Al" → "Diğer Kaynaklardan" → "Web'den" seçin.
API URL'sini girin
Açılan "Web'den" penceresine URL'yi yapıştırın ve "Tamam"a basın.
https://www.apiwebtufe.com/api/v1/gruplar/yearlyJSON kaydını yükleyin
"Gezgin" penceresinde "Kayıt" veya "Liste" seçeneğini göreceksiniz. "Listeye Dönüştür"e tıklayın.
Tabloya dönüştürün
"Değerlere Dönüştür" veya "Tabloya Dönüştür" düğmesine basın. Sütun sınırlayıcı olarak "Yok" seçin.
Sütunları genişletin
Column1 başlığındaki "genişlet" ikonuna (⇔) tıklayın. Tüm sütunları seçip "Tamam"a basın.
Tarih sütununu biçimlendirin
"date" sütununa sağ tıklayın → "Türü Değiştir" → "Tarih" seçin.
Sayısal sütunları biçimlendirin
Grup sütunlarını seçin → "Türü Değiştir" → "Ondalık Sayı" seçin.
Yükleyin
"Kapat ve Yükle" → "Kapat ve Yükle..." → "Tablo" seçeneğini işaretleyip "Yükle"ye basın. Veriler çalışma sayfanıza aktarılacak.
Aşağıdaki URL'leri Power Query'ye yapıştırarak istediğiniz veriyi çekebilirsiniz.
https://www.apiwebtufe.com/api/v1/tufe/yearlyhttps://www.apiwebtufe.com/api/v1/tufe/monthlyhttps://www.apiwebtufe.com/api/v1/gruplar/yearlyhttps://www.apiwebtufe.com/api/v1/gruplar/monthlyhttps://www.apiwebtufe.com/api/v1/gruplar/katkihttps://www.apiwebtufe.com/api/v1/harcama-gruplari/yearlyhttps://www.apiwebtufe.com/api/v1/harcama-gruplari/monthlyhttps://www.apiwebtufe.com/api/v1/ozel-gostergeler/yearlyhttps://www.apiwebtufe.com/api/v1/ozel-gostergeler/monthlyhttps://www.apiwebtufe.com/api/v1/pce/yearlyhttps://www.apiwebtufe.com/api/v1/pce/monthlyhttps://www.apiwebtufe.com/api/v1/pce/gruplar/yearlyhttps://www.apiwebtufe.com/api/v1/maddeler/yearlyhttps://www.apiwebtufe.com/api/v1/agirliklar/v2https://www.apiwebtufe.com/api/v1/aclik-siniri/yillikVeriler her ay güncellenmektedir. Excel'in sorguyu otomatik yenilemesi için aşağıdaki adımları izleyin.
Veriler güncellendiğinde Excel'de yeniden yüklemek için:
"Veri" sekmesi → "Tümünü Yenile" düğmesine basın.
Sorgu her açılışta veya belirli aralıklarda otomatik yenilenebilir:
"Veri" → "Sorgu ve Bağlantılar" → Sorguya sağ tıklayın → "Özellikler" → "Her ... dakikada bir yenile"Sorularınız için hakkında sayfasından iletişime geçebilirsiniz.
API'yi araştırma veya eğitim amaçlı kullanabilirsiniz. Ticari kullanım için lütfen önceden iletişime geçin.