API dokümantasyonu

Tüm veri uçları API key ister; aşağıdaki katalog uçları (markalar, yakıt türleri, iller, ilçeler) da dahil. Kayıt olduğunuzda bir key üretilir; Hesabım sayfasından yenisini oluşturabilir veya iptal edebilirsiniz.

curl -H "X-API-Key: afp_..." \
  "https://api-fuel-prices.bildirium.com/v1/fuel-prices?city=ankara"

Uçlar

Metot	Yol	Açıklama
GET	/v1/fuel-prices?city={city}&district=&brand=&fuel=&date=	Güncel fiyatlar. `city` zorunlu. `date` verilirse o tarihte yürürlükte olan fiyat döner.
GET	/v1/fuel-prices/history?city=&brand=&fuel=&from=&to=	Değişim bazlı fiyat serisi — grafik için hazır.
GET	/v1/fuel-prices/changes?from=&to=&city=&brand=	Zam/indirim olayları.
GET	/v1/reference-prices	EPDK'nın ülke geneli referans bülteni. Pompa fiyatı değildir.
GET	/v1/brands	Marka katalogu.
GET	/v1/fuel-types	Canonical yakıt türleri.
GET	/v1/cities	81 il.
GET	/v1/cities/{city}/districts	İlçeler; İstanbul ilçeleri yakalarıyla birlikte.

Yanıt sözleşmesi

Alan adları, tipleri ve iç içeliği dondurulmuştur. Bir kaynak veri vermediğinde alan null döner, ama şema değişmez.

{
  "meta": {
    "city": { "code": 6, "name": "Ankara", "slug": "ankara" },
    "district": null,
    "zone": null,
    "date": "2026-08-10",
    "currency": "TRY",
    "unit": "TL/lt",
    "vatIncluded": true,
    "count": 24,
    "fetchedAt": "2026-08-10T20:07:47+03:00",
    "stale": false
  },
  "prices": [
    {
      "brand": { "code": "opet", "name": "Opet" },
      "fuelType": "gasoline_95",
      "productName": "Kurşunsuz Benzin 95",
      "price": 69.33,
      "previousPrice": 67.27,
      "change": 2.06,
      "changePercent": 3.06,
      "priceKind": "pump",
      "effectiveFrom": "2026-08-08T00:00:00+03:00",
      "source": "opet-official-api",
      "attribution": "Source: Opet",
      "updatedAt": "2026-08-10T06:02:11+03:00"
    }
  ]
}

Bilmeniz gerekenler

Fiyatlar KDV dahil, birim TL/lt. v1 yalnız litre bazlı ürünleri kapsar (kalorifer yakıtı ve fuel oil TL/kg olduğu için kapsam dışı).
priceKind alanı fiyatın ne olduğunu söyler: pump fiilî pompa fiyatı, ceiling dağıtıcının EPDK'ya beyan ettiği tavan fiyat, official_reference ise EPDK'nın ülke geneli referansı.
İstanbul iki fiyat bölgesine ayrılır (zone: avrupa / anadolu). İlçe verirseniz doğru yaka otomatik seçilir.
effectiveFrom kaynakların gün bazlı yayınından üretilir; saat 00:00 +03:00 olarak varsayılır.
Hatalar RFC 7807 formatındadır: { status, title, detail, type }. 429 kota veya hız limiti, 503 hiç veri yok anlamına gelir.