Geliştirici

Hal Fiyatları API — Ücretsiz, OpenAPI

HepsiHalhal fiyatları API'si Türkiye'deki toptancı hallerinin günlük en düşük, ortalama ve en yüksek fiyatlarını ücretsiz olarak JSON ve CSV biçiminde sunar. Sözleşme makine-okunur bir OpenAPI şemasıyla yayımlanır; anahtarsız erişimde API anahtarı gerekmez.

Başlıca uç noktalar: /prices (güncel fiyat listesi), /prices/history/:productSlug (günlük geçmiş), /prices/export (CSV) ve /index/latest (haftalık endeks). Lisans, önbellek ve yeniden dağıtım koşulları API Kullanım Politikası'nda; verinin tazeliği veri sağlığı sayfasında izlenir.

Veri Türkiye toptancı hallerinden ve resmi kaynaklardan her gün derleniyor. Fiyat, geçmiş ve endeks uç noktaları ile curl örnekleri aşağıda listelenir; OpenAPI şemasıyla istemci kodu üretebilirsiniz. Düzenli kullanım için ücretsiz bir API anahtarı alın (Hesabım → API). Cevaplardaki veri tarihi ve kalite alanları bayat veri uyarıları için kullanılır; sıkça sorulan lisans ve kota soruları API Kullanım Politikası'nda yanıtlanır.

Base URL

https://hepsihal.com/api/v1

Format

JSON (UTF-8)

Rate Limit

600/dk · anahtarsız

Ticari & Yüksek Hacim

Yoğun kullanım için API anahtarı alın

Anahtarsız erişim ücretsizdir: IP başına 600/dk, fiyat uçlarında günde 300 istek. Düzenli entegrasyon için X-API-Key ile kullanıcı başına günlük kota, kullanım takibi ve anahtar iptali gelir; güncel kotalar aşağıdaki planlarda. Ücretsiz anahtar hesap içinden (Hesabım → API) oluşturulur; Pro tier manuel onaylanır.

API Anahtarı Oluştur →Pro / Premium

ERP ve ilan entegrasyonu

Canlıya dokunmadan sandbox ile başlayın

ERP'nizdeki kayıtları ilana dönüştüren uçlar pilot kapsamındadır. Önce test anahtarıyla sandbox'ta uçtan uca deneyin; canlı kurulum doğrulanmış firma ve yetkili onayıyla açılır. Pilot kapsamı

01
Test anahtarı alın
Hesabım → API sayfasından test (sandbox) anahtarı oluşturun. Anahtar hf_test_ ile başlar, yalnız bir kez gösterilir ve onay gerektirmez.
02
Sandbox'ta deneyin
İlan yazma, güncelleme, kapatma, mutabakat ve artımlı okuma /api/v1/sandbox/ altında canlıdakiyle aynı kurallarla çalışır. Veri canlı ilanlara karışmaz; 7 gün sonra silinir.
03
Pilot kurulumuna geçin
Canlı yazma, doğrulanmış firma ve firma yetkilisinin onayladığı kurulumla açılır. Kurulum anahtarı yalnız o firma adına çalışır.

Sandbox'ta ilk ilan

curl -X PUT https://hepsihal.com/api/v1/sandbox/listings/external/LOT-1 \
  -H "X-API-Key: $HF_API_KEY" -H "Content-Type: application/json" \
  -d '{"sourceVersion":1,"listing":{"listingType":"satis","productName":"Domates",
       "title":"Sera domatesi 10 ton","description":"Kasalı, birinci kalite.",
       "quantity":10,"quantityUnit":"ton","priceType":"pazarlik",
       "validUntil":"2026-12-31","contactPhone":"05000000000"}}'

Sürüm ve tekrar: Her yazma sourceVersion taşır. Aynı sürüm güvenli tekrardır, eski sürüm 409 stale_version döner.
Hatalar: Her hata error.code, error.message ve error.requestId içerir. Kota dolunca 429 rate_limit_exceeded ve Retry-After döner.
Kota ve plan: Kota kullanıcı başına, UTC günü penceresindedir; test ve canlı anahtarlar aynı kotayı paylaşır (ücretsiz plan 1.000 istek/gün). Planlar Pro sayfasında.
Kullanım hakkı ve destek: Veri kullanım koşulları API Kullanım Politikası'ndadır. Destek için iletişim formuna requestId ile yazın. Ölçülmüş bir SLA henüz yoktur.

Fiyat Verileri

Hal fiyatlarını sorgulama, filtreleme ve dışa aktarma.

GET/pricesCache: 5 dakika

Fiyat listesini döndürür. Şehir, kategori, tarih ve ürün bazında filtrelenebilir.

Parametreler

İsim	Tür	Zorunlu	Açıklama
city	string	hayır	Şehir adı veya kodu (örn. istanbul)
product	string	hayır	Ürün slug'ı (örn. domates)
category	string	hayır	Kategori slug'ı (örn. sebze)
range	string	hayır	Geçmiş penceresi, ör. 7d / 30d / 365d
latestOnly	boolean	hayır	Her ürün/hal için yalnız son kaydı getirir
page	number	hayır	Sayfa no (varsayılan: 1)
limit	number	hayır	Sayfa boyutu (maks. 100)

Örnek İstek

curl "https://hepsihal.com/api/v1/prices?city=istanbul&product=domates&limit=5"

Örnek Yanıt

{
  "items": [
    {
      "id": "...",
      "marketName": "İstanbul Büyükçekmece Hali",
      "productName": "Domates",
      "minPrice": "8.50",
      "maxPrice": "12.00",
      "avgPrice": "10.25",
      "unit": "kg",
      "recordedDate": "2026-04-21",
      "sourceName": "Resmi kaynak",
      "isStale": false,
      "qualityFlags": []
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "limit": 5,
    "latestRecordedDate": "2026-04-21"
  }
}

GET/prices/trendingCache: 10 dakika

Son 7 günde fiyatı en çok değişen ürünlerin özeti; ortalamanın yöntemi (avgPriceMethod) satırda yazar.

Parametreler

İsim	Tür	Zorunlu	Açıklama
limit	number	hayır	Sonuç sayısı (varsayılan: 20)

Örnek İstek

curl "https://hepsihal.com/api/v1/prices/trending?limit=10"

Örnek Yanıt

[
  {
    "productSlug": "domates",
    "productName": "Domates",
    "avgPrice": "10.25",
    "minPrice": "8.50",
    "maxPrice": "14.00",
    "recordCount": 284
  }
]

GET/prices/weekly-summary

Haftalık fiyat özeti — her ürün için min/max/ort ve hafta bazlı gruplandırma.

Parametreler

İsim	Tür	Zorunlu	Açıklama
week	string	hayır	ISO hafta, ör. 2026-29; varsayılan son tamamlanmış hafta

Örnek İstek

curl "https://hepsihal.com/api/v1/prices/weekly-summary?week=2026-29"

Örnek Yanıt

{
  "week": "2026-29",
  "weekStart": "2026-07-13",
  "weekEnd": "2026-07-19",
  "topRisers": [],
  "topFallers": []
}

GET/prices/history/:productSlug

Belirli bir ürünün günlük fiyat geçmişi (5+ yıla kadar).

Parametreler

İsim	Tür	Zorunlu	Açıklama
productSlug	string	evet	URL'de ürün slug'ı
range	string	hayır	Geçmiş penceresi, ör. 30d / 365d / 1825d (varsayılan: 7d)
market	string	hayır	Belirli hal/borsa slug'ı (opsiyonel)

Örnek İstek

curl "https://hepsihal.com/api/v1/prices/history/domates?range=365d"

Örnek Yanıt

[
  { "priceDate": "2026-04-21", "avgPrice": "10.25", "minPrice": "8.50", "maxPrice": "14.00" }
]

GET/prices/export

Fiyat verilerini CSV olarak indirir. Tüm filtreler geçerlidir.

Parametreler

İsim	Tür	Zorunlu	Açıklama
city	string	hayır	Şehir filtresi
product	string	hayır	Ürün filtresi
range	string	hayır	Geçmiş penceresi, ör. 7d / 30d / 365d

Örnek İstek

curl -o fiyatlar.csv "https://hepsihal.com/api/v1/prices/export?city=istanbul&range=30d"

Örnek Yanıt

market_name,product_name,min_price,max_price,avg_price,unit,price_date
İstanbul Büyükçekmece Hali,Domates,8.50,14.00,10.25,kg,2026-04-21

GET/prices/forecast/:productSlug

Yürüyen backtest, MAE/MAPE, naif baz çizgi ve drift kapısını geçen seriler için 7 günlük deneysel fiyat tahmini; eşik geçilmezse 422 döner.

Parametreler

İsim	Tür	Zorunlu	Açıklama
productSlug	string	evet	URL'de ürün slug'ı

Örnek İstek

curl "https://hepsihal.com/api/v1/prices/forecast/domates"

Örnek Yanıt

{
  "productSlug": "domates",
  "predictions": [
    { "date": "2026-04-22", "predicted": 10.8 }
  ],
  "validation": { "modelMape": 8.4, "baselineMape": 11.2, "publishable": true }
}

HepsiHal Endeksi

15 temel tarım ürününden oluşan haftalık fiyat endeksi.

GET/index/latestCache: 5 dakika

En güncel endeks değerini döndürür.

Örnek İstek

curl "https://hepsihal.com/api/v1/index/latest"

Örnek Yanıt

{
  "indexWeek": "2026-16",
  "indexValue": "98.81",
  "baseWeek": "2026-14",
  "basketAvg": "12.34",
  "productsCount": 13,
  "weekStart": "2026-04-14",
  "weekEnd": "2026-04-20"
}

GET/index/historyCache: 5 dakika

Endeks geçmişi — varsayılan 26 hafta.

Parametreler

İsim	Tür	Zorunlu	Açıklama
weeks	number	hayır	Kaç haftalık geçmiş (maks. 104)

Örnek İstek

curl "https://hepsihal.com/api/v1/index/history?weeks=8"

Örnek Yanıt

[
  { "indexWeek": "2026-14", "indexValue": "100.00", "basketAvg": "12.48", "productsCount": 13 },
  { "indexWeek": "2026-15", "indexValue": "98.81",  "basketAvg": "12.34", "productsCount": 13 }
]

GET/index/basket

Endeks sepetindeki ürün listesi.

Örnek İstek

curl "https://hepsihal.com/api/v1/index/basket"

Örnek Yanıt

{
  "basket": [
    { "slug": "domates", "label": "Domates" },
    { "slug": "biber",   "label": "Biber" }
  ]
}

Hal Listesi

Türkiye genelindeki aktif hal ve pazar bilgileri.

GET/markets

Tüm aktif hallerin listesi.

Parametreler

İsim	Tür	Zorunlu	Açıklama
city	string	hayır	Şehir filtresi

Örnek İstek

curl "https://hepsihal.com/api/v1/markets"

Örnek Yanıt

[
  {
    "id": "...",
    "name": "İstanbul Büyükçekmece Hali",
    "slug": "istanbul-buyukcekmece-hali",
    "city": "İstanbul",
    "isActive": true
  }
]

Yıllık Üretim

TÜİK kaynaklı yıllık tarımsal üretim verileri.

GET/production

Ürün bazlı yıllık üretim miktarları.

Parametreler

İsim	Tür	Zorunlu	Açıklama
product	string	hayır	Ürün adı
year	number	hayır	Yıl filtresi

Örnek İstek

curl "https://hepsihal.com/api/v1/production?product=domates&year=2024"

Örnek Yanıt

[
  { "year": 2024, "productName": "Domates", "quantityTons": 13200000, "source": "TÜİK" }
]

Fiyat Uyarıları

Hedef fiyat belirle, ürün o fiyata ulaştığında bildirim al.

GET/alerts

Kayıtlı e-posta'ya ait uyarı listesi.

Parametreler

İsim	Tür	Zorunlu	Açıklama
email	string	evet	Uyarı kaydedilmiş e-posta

Örnek İstek

curl "https://hepsihal.com/api/v1/alerts?email=ornek@mail.com"

Örnek Yanıt

[
  {
    "id": "...",
    "productName": "Domates",
    "targetPrice": "9.00",
    "direction": "below",
    "isActive": true
  }
]

POST/alerts

Yeni fiyat uyarısı oluşturur.

Örnek İstek

curl -X POST "https://hepsihal.com/api/v1/alerts" \
  -H "Content-Type: application/json" \
  -d '{"email":"ornek@mail.com","productSlug":"domates","targetPrice":9,"direction":"below"}'

Örnek Yanıt

{ "id": "...", "created": true }

DELETE/alerts/:id

Uyarıyı siler.

Parametreler

İsim	Tür	Zorunlu	Açıklama
id	string	evet	URL'de uyarı ID

Örnek İstek

curl -X DELETE "https://hepsihal.com/api/v1/alerts/abc-123"

Örnek Yanıt

{ "deleted": true }

Sürüm ve değişiklik kaydı

API v1

Geriye uyumlu alan eklemeleri v1 içinde yayınlanır. Alan kaldırma, anlam değiştirme veya zorunlu parametre ekleme yeni ana sürüm ve geçiş duyurusu gerektirir.

2026-08-14: Plan/kota sözleşmesi backend ayar kaynağına bağlandı; anahtarlı ve anonim rate-limit header rolleri ayrıldı.
2026-08-14: Fiyat cevaplarında public kaynak, veri tarihi ve kalite alanları; CSV'de filtre metadatası belgelendi.

Lisans, cache ve yeniden dağıtım koşulları için API Kullanım Politikası; destek için İletişim.

Embed Widget'lar

Güncel fiyat listesi ve HepsiHal Endeksi'ni kendi sitenize iframe olarak ekleyebilirsiniz. Koyu/açık tema, kategori, ürün slug listesi ve limit parametreleri desteklenir.

Güncel fiyat widget

<iframe src="https://hepsihal.com/fiyatlar/widget?limit=6" width="420" height="430" style="border:none;border-radius:16px;max-width:100%;" title="HepsiHal Güncel Hal Fiyatları"></iframe>

Özel ürün listesi

<iframe src="https://hepsihal.com/fiyatlar/widget?slugs=domates,biber,salatalik&theme=light&limit=3" width="420" height="260" style="border:none;border-radius:16px;max-width:100%;" title="HepsiHal Özel Fiyat Widget"></iframe>

Koyu tema

<iframe src="https://hepsihal.com/endeks/widget" width="320" height="168" style="border:none;border-radius:14px;" title="HepsiHal Endeksi"></iframe>

Açık tema

<iframe src="https://hepsihal.com/endeks/widget?theme=light" width="320" height="168" style="border:none;border-radius:14px;" title="HepsiHal Endeksi"></iframe>

Tüm embed örnekleri için /embed sayfasını kullanın.

Notlar

Tüm yanıtlar UTF-8 kodlamasında JSON'dır.
Tarih formatı YYYY-MM-DD, hafta formatı YYYY-WW (ISO 8601).
Cache başlıkları içeren endpoint'ler CDN veya servis worker ile önbelleklenebilir.
Yüksek hacimli entegrasyonlar için iletişime geçin.

Verilerimiz nasıl derleniyor?

HepsiHal fiyat verisi, resmî hal ve borsa listelerinden otomatik derlenen açık bir veri setidir. Son 30 günde 49 ayrı teknik kaynak kimliğinden fiyat kaydı geldi; 41 hal ve 22 borsanın fiyatları katalogda izlenir. Son 30 günde 29 ilden kayıt geldi. Elle fiyat girilmez; her satır kaynak, tarih, çeşit ve birim etiketiyle saklanır. Düzenli günlük seri 2020 yılında başlar; daha eski arşiv kayıtları kesintisiz seri sayılmaz. Aykırı fiyatlar yayından önce karantinaya alınır ve otomatik incelemeye düşer. Örneğin bir önceki kayda göre %400'den fazla artan ya da %80'den fazla düşen fiyat incelenmeden yayımlanmaz. Benzer kaynakların ortancasından dört kat sapan fiyat ve 400 günden eski kaynak kaydı da incelemeye alınır. Doğrulanamayan satır yayından çıkarılır ama silinmez; düzeltme süreci kayıt altında tutulur. Ortalama yayımlamayan kaynaklarda en düşük ve en yüksek fiyatın orta noktası ayrıca işaretlenir. Veri Creative Commons Atıf (CC BY) lisansıyla kaynak gösterilerek alıntılanabilir ve ücretsiz API ile toplu alınabilir.

Son kayıt 12 Kasım 2026. Hatalı kayıt görürseniz bize bildirin; süreç düzeltme politikasında yazılıdır.

Metodoloji · Veri kaynağı politikası · hal.gov.tr · Gizlilik ve KVKK · Hakkımızda

Sıkça sorulan sorular: veri ve yöntem

HepsiHal fiyat verisi nereden geliyor?

Son 30 günde 49 teknik kaynak kimliğinden kayıt geldi; kaynaklar hal, borsa ve resmî kurum listeleridir.

Fiyatlar ne sıklıkla güncellenir?

Kaynaklar yayımladıkça her gün; hafta sonu ve bayramda son iş gününün fiyatı gösterilir.

Hatalı bir fiyatı nasıl bildiririm?

İletişim sayfasından bildirin; kayıt birincil kaynakla karşılaştırılır, doğrulanamayan satır yayından çıkarılır.

Veriyi kendi sitemde kullanabilir miyim?

Evet; kaynak göstererek CC BY 4.0 lisansıyla kullanabilirsiniz, toplu erişim için ücretsiz API var.

Hal Fiyatları API — Ücretsiz, OpenAPI

Yoğun kullanım için API anahtarı alın

Canlıya dokunmadan sandbox ile başlayın

Test anahtarı alın

Sandbox'ta deneyin

Pilot kurulumuna geçin

Fiyat Verileri

HepsiHal Endeksi

Hal Listesi

Yıllık Üretim

Fiyat Uyarıları

API v1

Embed Widget'lar

Verilerimiz nasıl derleniyor?

Sıkça sorulan sorular: veri ve yöntem

HepsiHal fiyat verisi nereden geliyor?

Fiyatlar ne sıklıkla güncellenir?

Hatalı bir fiyatı nasıl bildiririm?

Veriyi kendi sitemde kullanabilir miyim?