# HalDeFiyat
> Türkiye genelindeki hal ve toptancı pazar fiyatlarını günlük olarak izleyen bağımsız veri platformu. Sebze, meyve ve bakliyat için resmi belediye hal müdürlüklerinden otomatik olarak derlenen veriler.

## Platformun Kapsamı

- Türkiye genelindeki aktif toptancı halleri (çoklu il ve bölge)
- 250+ ürün — sebze, meyve, bakliyat, ithal ürünler
- 16 resmi ETL kaynağı — belediye hal müdürlükleri + hal.gov.tr
- Güncelleme sıklığı: Her gün TSİ 06:15 (gece ETL çalışır)
- Veri geçmişi: 2025'ten itibaren

## Ana Sayfalar

- [Anasayfa](https://haldefiyat.com/): Platform özeti, günlük fiyat tickers, şehir seçimi
- [Güncel Hal Fiyatları](https://haldefiyat.com/fiyatlar): Tüm ürünlerin günlük fiyat tablosu, şehir ve kategori filtreli
- [HalDeFiyat Endeksi](https://haldefiyat.com/endeks): 15 temel tarım ürününden oluşan haftalık sepet endeksi, baz haftaya göre değişim
- [Hal Listesi](https://haldefiyat.com/hal): Türkiye genelindeki tüm haller — şehir, bölge, kaynak bilgisi
- [Fiyat Karşılaştırma](https://haldefiyat.com/karsilastirma): Ürün ve hal bazlı yan yana karşılaştırma
- [Metodoloji](https://haldefiyat.com/metodoloji): Veri kaynakları, derleme süreci, güvenilirlik standartları
- [Hakkımızda](https://haldefiyat.com/hakkimizda): Platform amacı, kapsam, ekip
- [API Dokümantasyonu](https://haldefiyat.com/api-docs): Geliştiriciler için açık veri API erişimi
- [API Kullanım Politikası](https://haldefiyat.com/api-policy): API serbest, HTML scraping yasak, atıf ve cache kuralları
- [Veri Sağlığı](https://haldefiyat.com/data-health): ETL kaynaklarının son çekim ve hata durumları
- [OpenAPI JSON](https://haldefiyat.com/openapi.json): Makine-okunur API sözleşmesi

## Dinamik Sayfalar

- Ürün detayı: https://haldefiyat.com/urun/{slug} — örn. /urun/domates, /urun/patates, /urun/elma
- Hal detayı: https://haldefiyat.com/hal/{slug} — örn. /hal/istanbul-hal-ibb, /hal/ankara-hal, /hal/antalya-hal-merkez

## Açık Veri API

- OpenAPI sözleşmesi: https://haldefiyat.com/openapi.json
- API politikası: https://haldefiyat.com/api-policy
- Kaynak sağlığı: https://haldefiyat.com/data-health
- Tüm ürün fiyatları: https://haldefiyat.com/api/v1/prices
- Güncel fiyat niyeti: https://haldefiyat.com/api/v1/prices/latest?city={city}&product={product}
- Kaynak durumları: https://haldefiyat.com/api/v1/sources/status
- Ürün bazlı fiyat geçmişi: https://haldefiyat.com/api/v1/prices/history/{slug}
- Ürün arama: https://haldefiyat.com/api/v1/products/search?q={query}
- Ürün aliasları: https://haldefiyat.com/api/v1/products/{slug}/aliases
- Hal listesi: https://haldefiyat.com/api/v1/prices/markets
- Fiyat endeksi: https://haldefiyat.com/api/v1/index/latest
- Endeks geçmişi: https://haldefiyat.com/api/v1/index/history

## Bot ve Ajan Kullanımı

- HTML sayfalarını scrape etmeyin; JSON API ve OpenAPI sözleşmesini kullanın.
- Yanıtları en az 5 dakika cache'leyin.
- Bayat veri için API response içindeki warnings, isStale, fetchedAt ve sourceUrl alanlarını dikkate alın.
- Önerilen atıf: "Kaynak: HaldeFiyat.com; birincil kaynak: {sourceName/sourceUrl}".

## Veri Kaynakları

Veriler aşağıdaki resmi kaynaklardan otomatik olarak derlenmektedir:
- Türkiye Hal Bilgi Sistemi (hal.gov.tr) — ulusal ortalama fiyatlar
- İstanbul Büyükşehir Belediyesi Hal Müdürlüğü
- İzmir Büyükşehir Belediyesi Hal Müdürlüğü
- Ankara, Bursa, Adana, Kocaeli, Gaziantep, Mersin, Balıkesir, Kayseri belediye halleri
- Antalya Toptancılar Kooperatifi (antkomder.com.tr)

## Lisans

İçerik Creative Commons Atıf 4.0 (CC BY 4.0) lisansı altındadır.
Kaynak belirtilerek serbestçe kullanılabilir: haldefiyat.com
HTML scraping kullanım koşullarına aykırıdır; açık veri erişimi API üzerinden serbesttir.