🆕 YeniPCE-Uyarlamalı Web TÜFE Endeksi yayında — Fisher-Ideal zincirleme metodoloji ile.

API Dokümantasyonu

Web TÜFE verilerine REST API üzerinden erişin — Python, Excel, R veya herhangi bir araçla.

Genel Bakış

Base URLhttps://www.apiwebtufe.com/api/v1

Kimlik Doğrulama

Gerekmiyor — herkese açık

Yanıt Formatı

JSON (UTF-8)

Güncelleme

Her ayın 24'ü (kesinleşme)

Not: API şu an yalnızca GET isteklerini desteklemekte olup hız limiti uygulanmaktadır. Toplu veri indirmek için aşağıdaki CSV/Excel indirme bağlantılarını tercih edin.

Endpoint Listesi

TÜFE (Manşet)

GET
https://www.apiwebtufe.com/api/v1/tufe

Özet: son tarih, yıllık %, aylık %, önceki aya göre değişim ve tam seriler

GET
https://www.apiwebtufe.com/api/v1/tufe/yearly

Yıllık değişim zaman serisi · [{date, value}]

GET
https://www.apiwebtufe.com/api/v1/tufe/monthly

Aylık değişim zaman serisi · [{date, value}]

GET
https://www.apiwebtufe.com/api/v1/tufe/endeks

Endeks seviyesi (2025=100) · [{date, value}]

GET
https://www.apiwebtufe.com/api/v1/tufe/tuik-comparison

Web TÜFE ve TÜİK endeks karşılaştırması

GET
https://www.apiwebtufe.com/api/v1/tufe/tuik-yearly

TÜİK yıllık değişim serisi

GET
https://www.apiwebtufe.com/api/v1/tufe/tuik-monthly

TÜİK aylık değişim serisi

Ana Gruplar (12 Grup)

GET
https://www.apiwebtufe.com/api/v1/gruplar/yearly

Yıllık değişim — her sütun bir grup adı

GET
https://www.apiwebtufe.com/api/v1/gruplar/monthly

Aylık değişim

GET
https://www.apiwebtufe.com/api/v1/gruplar/index

Endeks sevileri (2025=100)

GET
https://www.apiwebtufe.com/api/v1/gruplar/katki

Manşet enflasyona aylık katkı (puan)

GET
https://www.apiwebtufe.com/api/v1/gruplar/latest

Son dönem: {date, items:[{name, value}]}

Harcama Grupları (13 Grup)

GET
https://www.apiwebtufe.com/api/v1/harcama-gruplari/yearly

Yıllık değişim — 13 ana harcama grubu

GET
https://www.apiwebtufe.com/api/v1/harcama-gruplari/monthly

Aylık değişim

GET
https://www.apiwebtufe.com/api/v1/harcama-gruplari/index

Endeks sevileri

GET
https://www.apiwebtufe.com/api/v1/harcama-gruplari/katki

Manşete katkı payları

Özel Kapsamlı Göstergeler

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/yearly

Çekirdek, enerji hariç vb. göstergeler — yıllık

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/monthly

Aylık değişim

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/index

Endeks sevileri

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/katki

Katkı payları (düzey 1 — 14 grup)

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/katki2

Katkı payları — düzey 2 (6 grup)

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/katki3

Katkı payları — düzey 3 (4 grup)

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/katki4

Katkı payları — düzey 4 (Mallar/Hizmet)

GET
https://www.apiwebtufe.com/api/v1/ozel-gostergeler/latest

Son dönem özeti · ?change_type=yearly|monthly

PCE (Kişisel Tüketim Harcamaları)

GET
https://www.apiwebtufe.com/api/v1/pce/summary

PCE özet: son tarih, yıllık, aylık, değişim

GET
https://www.apiwebtufe.com/api/v1/pce/yearly

PCE yıllık değişim · [{date, value}]

GET
https://www.apiwebtufe.com/api/v1/pce/monthly

PCE aylık değişim

GET
https://www.apiwebtufe.com/api/v1/pce/endeks

PCE endeks sevileri

GET
https://www.apiwebtufe.com/api/v1/pce/gruplar/yearly

PCE grupları yıllık değişim

GET
https://www.apiwebtufe.com/api/v1/pce/gruplar/monthly

PCE grupları aylık değişim

GET
https://www.apiwebtufe.com/api/v1/pce/gruplar/agirlik

PCE sepet ağırlıkları (aylık güncellenen)

Maddeler (~390 Ürün/Hizmet)

GET
https://www.apiwebtufe.com/api/v1/maddeler/names

Tüm madde adları listesi · [string]

GET
https://www.apiwebtufe.com/api/v1/maddeler/yearly

Tüm maddeler yıllık değişim

GET
https://www.apiwebtufe.com/api/v1/maddeler/monthly

Aylık değişim · ?search=ekmek ile arama

GET
https://www.apiwebtufe.com/api/v1/maddeler/katki

Manşete katkı payları

Diğer

GET
https://www.apiwebtufe.com/api/v1/agirliklar/v2

Sepet ağırlıkları — anaGrup, temelBaslik, madde kırılımı (2025 ve 2026)

GET
https://www.apiwebtufe.com/api/v1/aclik-siniri

Açlık sınırı endeks serileri

GET
https://www.apiwebtufe.com/api/v1/aclik-siniri/yillik

Açlık sınırı yıllık değişim

GET
https://www.apiwebtufe.com/api/v1/aclik-siniri/aylik

Aylık değişim

GET
https://www.apiwebtufe.com/api/v1/mevsimsel

Mevsimsel düzeltilmiş seri (TRAMO-SEATS)

GET
https://www.apiwebtufe.com/api/v1/ana-egilim

Ana eğilim göstergesi

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 openpyxl

Hı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.

1

Power Query'yi açın

Excel'de şeritteki "Veri" sekmesine tıklayın. "Veri Al" → "Diğer Kaynaklardan" → "Web'den" seçin.

2

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/yearly
3

JSON kaydını yükleyin

"Gezgin" penceresinde "Kayıt" veya "Liste" seçeneğini göreceksiniz. "Listeye Dönüştür"e tıklayın.

4

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.

5

Sütunları genişletin

Column1 başlığındaki "genişlet" ikonuna (⇔) tıklayın. Tüm sütunları seçip "Tamam"a basın.

6

Tarih sütununu biçimlendirin

"date" sütununa sağ tıklayın → "Türü Değiştir" → "Tarih" seçin.

7

Sayısal sütunları biçimlendirin

Grup sütunlarını seçin → "Türü Değiştir" → "Ondalık Sayı" seçin.

8

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.

İpucu: Birden fazla endpoint'i ayrı sorgular olarak ekleyebilirsiniz. "Veri" → "Sorgu ve Bağlantılar" panelinden tüm sorgularınızı yönetebilirsiniz.

Aşağıdaki URL'leri Power Query'ye yapıştırarak istediğiniz veriyi çekebilirsiniz.

TÜFE Yıllıkhttps://www.apiwebtufe.com/api/v1/tufe/yearly
TÜFE Aylıkhttps://www.apiwebtufe.com/api/v1/tufe/monthly
Ana Gruplar Yıllıkhttps://www.apiwebtufe.com/api/v1/gruplar/yearly
Ana Gruplar Aylıkhttps://www.apiwebtufe.com/api/v1/gruplar/monthly
Katkı Paylarıhttps://www.apiwebtufe.com/api/v1/gruplar/katki
Harcama Grupları Yıllıkhttps://www.apiwebtufe.com/api/v1/harcama-gruplari/yearly
Harcama Grupları Aylıkhttps://www.apiwebtufe.com/api/v1/harcama-gruplari/monthly
Özel Kapsamlı Yıllıkhttps://www.apiwebtufe.com/api/v1/ozel-gostergeler/yearly
Özel Kapsamlı Aylıkhttps://www.apiwebtufe.com/api/v1/ozel-gostergeler/monthly
PCE Yıllıkhttps://www.apiwebtufe.com/api/v1/pce/yearly
PCE Aylıkhttps://www.apiwebtufe.com/api/v1/pce/monthly
PCE Grupları Yıllıkhttps://www.apiwebtufe.com/api/v1/pce/gruplar/yearly
Maddeler Yıllıkhttps://www.apiwebtufe.com/api/v1/maddeler/yearly
Ağırlıklarhttps://www.apiwebtufe.com/api/v1/agirliklar/v2
Açlık Sınırıhttps://www.apiwebtufe.com/api/v1/aclik-siniri/yillik

Veriler 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.

API'yi keşfet