# HepsiHal
> 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ı

- 58 aktif toptancı hali (çoklu il ve bölge)
- 1188 izlenen ürün
- 49 izlenen resmi veri kaynağı
- Güncelleme sıklığı: Kaynakların resmi yayın takvimine göre otomatik ETL
- Veri geçmişi: 2004-03-02 tarihinden itibaren

## Ana Sayfalar

- [Anasayfa](https://hepsihal.com/): Platform özeti, günlük fiyat tickers, şehir seçimi
- [Güncel Hal Fiyatları](https://hepsihal.com/hal-fiyatlari): Tüm ürünlerin günlük fiyat tablosu, şehir ve kategori filtreli
- [HepsiHal Endeksi](https://hepsihal.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://hepsihal.com/hal): Türkiye genelindeki tüm haller — şehir, bölge, kaynak bilgisi
- [Fiyat Karşılaştırma](https://hepsihal.com/karsilastirma): Ürün ve hal bazlı yan yana karşılaştırma
- [Metodoloji](https://hepsihal.com/metodoloji): Veri kaynakları, derleme süreci, güvenilirlik standartları
- [Hakkımızda](https://hepsihal.com/hakkimizda): Platform amacı, kapsam, ekip
- [API Dokümantasyonu](https://hepsihal.com/api-docs): Geliştiriciler için açık veri API erişimi
- [API Kullanım Politikası](https://hepsihal.com/api-policy): API serbest, HTML scraping yasak, atıf ve cache kuralları
- [Veri Sağlığı](https://hepsihal.com/data-health): ETL kaynaklarının son çekim ve hata durumları
- [OpenAPI JSON](https://hepsihal.com/api/docs/json): Makine-okunur API sözleşmesi

## Dinamik Sayfalar

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

## Açık Veri API

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

## Hakkında (Key Facts)

- Platform adı: HepsiHal
- İşletmeci: GZL Teknoloji
- Tür: Bağımsız açık veri platformu (hal fiyatları)
- Dil: Türkçe
- Kapsam: Türkiye geneli toptancı halleri, ticaret borsaları ve zincir market fiyatları
- Veri lisansı: CC BY 4.0 (kaynak belirtilerek serbest)
- Şeffaflık politikası: https://hepsihal.com/seffaflik
- Metodoloji: https://hepsihal.com/metodoloji

## İletişim

- E-posta: info@hepsihal.com
- Telefon: +90 530 048 41 83
- İletişim sayfası: https://hepsihal.com/iletisim
- Basın: https://hepsihal.com/basin
- X (Twitter): https://x.com/hepsihal
- Instagram: https://www.instagram.com/hepsihal/
- Facebook: https://www.facebook.com/people/HepsiHal/61590611212775/
- YouTube: https://www.youtube.com/@HepsiHal
- LinkedIn: https://www.linkedin.com/company/146605944/

## Lisans

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