Ücretsiz Türkiye veri API’si
Altın fiyatları, döviz kurları, depremler, namaz vakitleri, akaryakıt, nöbetçi eczaneler: hepsi tek bir web adresiyle, JSON olarak.
GET /gold?category=gram{
"type": "gram_24k",
"sell": 6425.75,
"price_date": "2026-10-26",
"attribution": {
"text": "Veri: Turkpidya"
}
}Canlı veriler
Bir karta dokunun, aşağıda hemen deneyin.
GET /fx/USD
GET /gold?category=gram
GET /fuel?city=istanbul
GET /earthquakes
GET /prayer-times?city=istanbul
GET /pharmacies/on-duty
GET /meds/lookup?q=…
İlk isteğiniz
Bir konu seçin ve veriyi isteyin. Anlaşılır özet ile programın aldığı ham cevap arasında geçiş yapın.
TCMB'nin dolar, euro ve diğer para birimleri için lira kurları. Seyahat bütçesi ya da fatura için.
Gerçek, salt okunur bir istek yapar.
KaynakTCMB (Türkiye Cumhuriyet Merkez Bankası)
Ne geldiğini görmek için “Veriyi getir”e basın.
Kurulum yok. Kod yok. Sadece deneyin.
JSON cevabını görmek için bir istek yapın.Bu kod, yukarıdaki denemeyle aynı soruyu sorar. Tarayıcı sitenizden gelen isteği engellerse sunucunuzda çalıştırın.
Tek kural
API ücretsiz. Karşılığında tek isteğimiz, verinin göründüğü her yerde görünür bir bağlantı.
attribution alanında bağlantı hazır gelir: metni, etiketli adresi ve kopyalanacak HTML'i.web_url, aynı verinin Turkpidya sayfasıdır. ?lang=tr eklerseniz Türkçe sayfaya gider.<a href="https://turkpidya.com/tr/altin-fiyatlari/">Veri: Turkpidya</a>Kodsuz
İki satırı yapıştırın: canlı altın, döviz, deprem, namaz vakti ya da nöbetçi eczane kutusu görünür. Kaynak bağlantısı sizin sayfanızda kalır.
Kutu kendini 5 dakikada bir yeniler. Kaynak bağlantısını silmeyin: verinin ücretsiz kalmasının tek şartı o.
İsteğe bağlı
Anahtarsız istekler çalışmaya devam eder. Anahtar size şunları verir:
Anahtarı her isteğe ?key=... olarak ya da X-API-Key başlığında ekleyin.
Vitrin
Kaynak bağlantısını gösteren uygulama ve siteler. Sizinki de burada olabilir.
İlk sırada sizin uygulamanız olabilir. Ücretsiz anahtar alırken “vitrine ekleyin” kutusunu işaretleyin.
Ücretsiz anahtar Veri koleksiyonu
Enflasyon, kira artış sınırları, asgari ücret ve vergi dilimleri, konut fiyatları, turizm, köprü ve otoyol ücretleri, müzeler. Her biri güncel hâli, geçmişi ve şemasıyla. OpenAPI dosyası (tüm adresler)
calendar-eventscpiearthquake-statsearthquakeseconomic-seriesenergy-pricesfood-cpifuel-brandsfuel-historyfx-historyfx-rateshousing-indexinternational-wagesmarket-historymuseum-passesmuseumspayroll-parameterspharmaciesprayer-timesprovincesrent-rulesroutestollstourism-entriestourism-receiptsGET /fxGET /fx/{currency}Güncelleme: Her iş günü 15:30 civarı · Cevabı şu süre saklayın: 1 saat
Bunlar merkez bankası referans kurlarıdır. Banka ya da döviz bürosu farklı kur verebilir.
Bu API adresini aç GET /goldGüncelleme: 5 dakikada bir · Cevabı şu süre saklayın: 5 dakika
Alış ve satış ayrı fiyatlardır. Tüm tutarlar Türk lirasıdır; kullanmadan önce kaydın tarihine bakın. Her fiyat kaynağını adıyla verir.
Bu API adresini aç GET /prayer-timesGET /prayer-times/citiesGüncelleme: Her gün · Cevabı şu süre saklayın: Gece yarısına kadar
Yerel camiinizin takvimi birkaç dakika farklı olabilir.
Bu API adresini aç GET /fuelGüncelleme: 6 saatte bir · Cevabı şu süre saklayın: 1 saat
Cevap şehir ortalamasıdır; belirli bir istasyonun fiyatı farklı olabilir.
Bu API adresini aç GET /earthquakesGET /earthquakes/latestGüncelleme: 5 dakikada bir · Cevabı şu süre saklayın: 5 dakika
Bu, bildirilen olayların kaydıdır; erken uyarı sistemi değildir.
Bu API adresini aç GET /pharmacies/on-dutyGüncelleme: Saatte bir · Cevabı şu süre saklayın: En çok 5 dakika
Gitmeden önce eczaneyi arayın. Acil durumda 112'yi arayın.
Bu API adresini aç GET /meds/lookupGET /meds/suggestGüncelleme: Haftada bir (pazar) · Cevabı şu süre saklayın: 1 saat
Aynı etken madde, iki ilacın birbirinin yerine güvenle kullanılabileceği anlamına gelmez. Mutlaka eczacıya danışın.
Bu API adresini aç Tüm adresler https://turkpidya.com/wp-json/turkpidya-data/v1 ile başlar. Eski turkpidya-gold/v1 ve turkpidya-earthquake/v1 bağlantıları da çalışır.
Meraklı insanlar ve yardımsever yapay zekâ için
Turkpidya'yı MCP destekleyen bir yapay zekâ asistanına bağlayın. Sonra normal bir soru sorun; asistan cevabı aynı kaynaklardan bulsun.
Her cevapta web_url olduğu için asistan kaynağı bağlantısıyla gösterebilir.
“Bana euro kurunu söyler misin?”
Kuru okur, kaynağı söyler ve kaydın tarihini verir.
Node.js 18+ ve Claude Code gerekir. Terminalde çalıştırın:
claude mcp add turkey-data -- npx -y turkey-data-mcpSık sorulanlar
Birkaç basit kural hizmeti herkes için kullanışlı tutar.
Adres başına dakikada 60 istek (ücretsiz anahtarla 300). 429 alırsanız durun ve Retry-After başlığındaki süre kadar bekleyin.
Cache-Control başlığına uyun. Cevaptaki tarihi her zaman kontrol edin: başarılı bir istek eski bir kayıt döndürebilir.
Veriyi herkese açık gösterdiğinizde Turkpidya'ya görünür bir bağlantı ekleyin. Ham akışları satmayın ve aynı veriyi tekrar tekrar istemeyin.
Bir programın başka bir programdan bilgi istemesinin yolu. Burada soru bir web adresi, cevap ise Türkiye hakkında veri.
Bir tür bilginin adresi. Örneğin /gold altın fiyatlarını, /fx/USD dolar kurunu ister.
Etiketlerle düzenlenmiş metin. "currency": "TRY" içinde etiket currency, değer TRY. Uygulamanız her değeri ayrı okuyabilir.
Bilgi okuma isteği. Bu sayfadaki tüm adresler GET kullanır. Veriyi istemek onu değiştirmez.
Bir süre yeniden kullandığınız kayıtlı cevap. Uygulamanızı hızlandırır ve aynı bilgiyi tekrar tekrar istemenizi önler.
Belli bir sürede izin verilen en fazla istek. Ücretsiz API adres başına dakikada 60 isteğe (anahtarla 300) izin verir.
Başka bir web sitesindeki sayfanın bu API'yi çağırmasına izin veren tarayıcı izni. Bu API her siteye izin verir.
Yapay zekâ asistanlarını araçlara bağlamanın ortak yolu. Turkpidya MCP sunucusu, uyumlu bir asistanın bu API'ye soru sormasını sağlar.
Bir kayda eklenen tarih ve saat. Sondaki +03:00, saatin UTC'den üç saat ileride, yani İstanbul saati olduğunu gösterir.
İsteğin sonucunu açıklayan kısa sayı. 200 çalıştı, 404 kayıt bulunamadı, 429 yeniden denemeden önce bekleyin demektir.
Boş cevap: o istek için kayıt yok; nota ve kaynak tarihine bakın. 400: filtrelerinizi kontrol edin. 404: istenen kayıt ya da tarih yok. 429: yeniden denemeden önce bekleyin. 503: hizmet ya da veri seti geçici olarak kullanılamıyor.
API'yi uygulamalarda, araştırmalarda ve kişisel projelerde bu sınırlar içinde kullanın. Veri olduğu gibi sunulur; güncellik ya da kesintisizlik garantisi yoktur. Finansal, tıbbi ya da acil durum tavsiyesi değildir.
Daha yüksek sınırlar, geçmiş veri ya da hizmet anlaşması mı lazım? [email protected] adresinden yazın