Geliştirici API'si

Türkiye Yakıt Fiyatları API'si

14.660 istasyondan günlük güncellenen benzin, motorin ve LPG fiyatları. JSON REST API ile kendi ürününüze bağlayın.

14.660

İstasyon

81

İl Kapsamı

Günlük

Veri Yenileme

3 Tür

Benzin · Motorin · LPG

Ne Çözer?

Filo Yakıt Maliyeti Optimizasyonu

Araçlarınızın güzergâhındaki istasyonları rota boyunca sıralı çekin. Güncel veriyi kendi filo yazılımınıza bağlayıp litre başına maliyeti düşürün.

/api/stations/along-route

Uygulamana Canlı Fiyat Entegrasyonu

Harita veya mobil uygulamanıza istasyon bazlı güncel benzin, motorin ve LPG fiyatlarını konum bilgileriyle birlikte bağlayın.

/api/stations

Pazar / Fiyat Analizi ve Raporlama

Türkiye geneli ortalama, minimum ve maksimum fiyatlarla pazar trendlerini izleyin. Günlük güncellenen veriyle rapor ve analiz panolarınızı besleyin.

/api/prices

Hızlı Başlangıç

1

Anahtarsız Deneyin

Ulusal fiyatlar ucu anahtar gerektirmez. Anonim erişim, anahtar kotası uygulanan uçlarda IP başına günde 100 istekle sınırlıdır.

bash
curl "https://ucuzyakitbul.com.tr/api/prices/national"
2

API Anahtarı Alın

Başvuru formunu doldurun. Başvurular manuel olarak incelenir; onaylanan başvurular için anahtarınız e-postayla iletilir.

3

İlk İsteğinizi Gönderin

bash
curl -H "x-api-key: API_ANAHTARINIZ" \
  "https://ucuzyakitbul.com.tr/api/stations?city=İstanbul&limit=3"

Kimlik Doğrulama

Müşteri API anahtarınızı iki taşıyıcıdan biriyle gönderebilirsiniz (ikisi birlikte gönderilirse x-api-key kullanılır):

http
x-api-key: API_ANAHTARINIZ
# veya
Authorization: Bearer API_ANAHTARINIZ

Bearer taşıyıcısı yalnızca JWT olmayan anahtarları müşteri anahtarı olarak kabul eder. Mobil uygulamanın kullanıcı giriş token'ı (JWT) bir müşteri API anahtarı değildir; genel API'lerde anahtarsız (anonim) kota kapsamında değerlendirilir.

  • Anahtar gönderilmezse: istek anonim değerlendirilir (İstek Limitleri bölümündeki anonim kota).
  • Bilinmeyen anahtar: 401 — Geçersiz API anahtarı. İstek anonim kotaya düşürülmez.
  • Devre dışı anahtar: 403 — API anahtarı devre dışı.
  • Süresi dolmuş anahtar: 403 — API anahtarının süresi doldu.

İstemci notu: Tarayıcı-dışı istemciler (curl, Python, Postman vb.) exact GET /api/stations ve GET /api/stations/along-route uçlarında UA engelini geçmek için API anahtarı sunmalıdır; anahtarsız tarayıcı-dışı istekler bu uçlarda 403 alır. /api/prices tarayıcı şartı olmadan müşteri anahtarını opsiyonel olarak kabul eder ve anahtar sunulursa plan kotası uygular. Diğer /api/stations/* alt yolları (örn. /api/stations/{id}, /api/stations/{id}/price-history) tarayıcı-yönelimli web uçlarıdır; API anahtarı bu alt yollarda tarayıcı-dışı erişim açmaz. /api/prices/national tarayıcı-dışı istemcilerden anahtarsız çağrılabilir.

Endpoint'ler

GET/api/stationsAnahtar opsiyonel · tarayıcı-dışı istemcide zorunlu

İstasyonları listele, filtrele ve sırala. Offset sıfırdan büyük olduğunda veya efektif limit 100'ü aştığında boş olmayan city, geçerli yapılandırılmış coğrafya ya da serbest arama terimi üreten q veya birlikte verilen sonlu lat/lng gerekir. Ham alanlar korunur; her istasyon ve fiyat satırı ayrıca kanonik gösterim bilgisini taşır. fuel verilirse yanıt, istenen yakıt için güven-öncelikli sıralama ve tasarruf metadata'sı da içerir.

ParametreTipAçıklama
citystringBoş olmayan şehir adı (örn: İstanbul)
fuelstringYakıt türü: Benzin, Motorin, LPG
lat, lngnumberBirlikte verilmesi gereken sonlu GPS koordinatları
radiusnumberArama yarıçapı km (varsayılan: 50)
sortstringSıralama: price, distance, quality
limitintegerPozitif sonuç sayısı (etkin üst sınır: 500; varsayılan: 20)
offsetintegerBaşlangıç konumu (0-1000; varsayılan: 0)
qstringTam resmi il, ilçe veya il+ilçe sorgusunda yapılandırılmış coğrafya filtresi; diğer girdilerde istasyon/marka serbest metin araması
bash
curl -H "x-api-key: API_ANAHTARINIZ" \
  "https://ucuzyakitbul.com.tr/api/stations?city=İstanbul&fuel=Benzin&limit=5"
Örnek Yanıt
json
{
  "stations": [
    {
      "id": "ornek-istasyon-id",
      "name": "Örnek İstasyon",
      "brand": "Opet",
      "city": "İstanbul",
      "district": "Kadıköy",
      "latitude": 40.9867,
      "longitude": 29.0261,
      "fuelPrices": [
        {
          "fuelType": "Benzin",
          "price": 52.34,
          "source": "BRAND_OPET",
          "confidence": 96,
          "updatedAt": "2026-08-13T06:30:00.000Z",
          "sourceValueChangedAt": "2026-08-13T06:30:00.000Z",
          "presentation": {
            "freshnessAt": "2026-08-13T06:30:00.000Z",
            "stale": false,
            "ageLabel": "2 saat önce",
            "sourceFamily": "official-brand",
            "sourceLabel": "Resmî marka verisi",
            "showTimestamp": true,
            "isEstimate": false
          }
        }
      ],
      "presentation": {
        "listName": "Opet - Kadıköy",
        "title": "Örnek İstasyon",
        "brandLabel": "Opet",
        "brandVerified": true
      }
    }
  ],
  "total": 1,
  "hasMore": false,
  "presentation": {
    "orderedStationIds": ["ornek-istasyon-id"],
    "cheapestStationId": "ornek-istasyon-id",
    "cheapestIsEstimate": false,
    "savings50L": 0
  }
}

Şema route kodundaki gerçek yanıtı yansıtır; değerler temsilîdir.

GET/api/stations/along-routeAnahtar opsiyonel · tarayıcı-dışı istemcide zorunlu

İki nokta arasında hesaplanmış rota, sıralı yakıt durakları ve veri tazeliği; ham veri dışa aktarımı değildir. Tüm erişim türlerinde ayrıca IP başına 20 rota/dk bağımsız tavan uygulanır.

ParametreTipAçıklama
from, tostringBaşlangıç ve varış şehri (ikisi birlikte)
fromLat, fromLngnumberBaşlangıç koordinatları (şehir adlarına alternatif)
toLat, toLngnumberVarış koordinatları (şehir adlarına alternatif)
fuelTypestringYakıt türü: Benzin, Motorin, LPG (varsayılan: Benzin)
radiusnumberRota koridoru km (1-100, varsayılan: 20)
limitnumberÖnerilecek durak sayısı (1-20, varsayılan: 5)
presetKmnumberBilinen rota mesafesi km (opsiyonel)
bash
curl -H "x-api-key: API_ANAHTARINIZ" \
  "https://ucuzyakitbul.com.tr/api/stations/along-route?from=İstanbul&to=Ankara&fuelType=Motorin"
Örnek Yanıt
json
{
  "route": {
    "from": { "lat": 41.0082, "lng": 28.9784 },
    "to": { "lat": 39.9334, "lng": 32.8597 },
    "straightLineKm": 350,
    "estimatedKm": 450,
    "isRealRoute": true
  },
  "stations": [
    {
      "id": "ornek-istasyon-id",
      "name": "Örnek İstasyon",
      "brand": "Opet",
      "city": "Bolu",
      "district": "Merkez",
      "latitude": 40.73,
      "longitude": 31.61,
      "fuelType": "Motorin",
      "price": 48.25,
      "source": "BRAND_OPET",
      "confidence": 96,
      "updatedAt": "2026-07-27T08:00:00.000Z",
      "sourceValueChangedAt": "2026-07-27T08:00:00.000Z",
      "routeOrderKm": 210,
      "distanceFromRoute": 1.2,
      "freshness": { "tier": "today", "label": "Bugün", "ageHours": 2.5 },
      "sourceTier": { "tier": "official", "label": "Resmî marka verisi" }
    }
  ],
  "priceStations": [
    {
      "id": "ornek-istasyon-id",
      "price": 48.25,
      "source": "BRAND_OPET",
      "confidence": 96,
      "updatedAt": "2026-07-27T08:00:00.000Z",
      "sourceValueChangedAt": "2026-07-27T08:00:00.000Z",
      "freshness": { "tier": "today", "label": "Bugün", "ageHours": 2.5 },
      "savingsEligible": true
    }
  ],
  "corridorPriceStations": [
    {
      "id": "ornek-istasyon-id",
      "price": 48.25,
      "source": "BRAND_OPET",
      "confidence": 96,
      "updatedAt": "2026-07-27T08:00:00.000Z",
      "sourceValueChangedAt": "2026-07-27T08:00:00.000Z",
      "freshness": { "tier": "today", "label": "Bugün", "ageHours": 2.5 },
      "savingsEligible": true
    }
  ],
  "warnings": []
}

Şema route kodundaki gerçek yanıtı yansıtır; değerler temsilîdir.

GET/api/pricesAnahtar opsiyonel

Yalnız yayındaki istasyonlardan hesaplanan Türkiye geneli yakıt türü bazlı ortalama / minimum / maksimum fiyatlar. Yanıt her tür için ayrıca _count (kayıt sayısı) içerir; örnek kısaltılmıştır.

bash
curl -H "x-api-key: API_ANAHTARINIZ" \
  "https://ucuzyakitbul.com.tr/api/prices"
Örnek Yanıt
json
{
  "averages": [
    {
      "fuelType": "Benzin",
      "_avg": {
        "price": 72.74
      },
      "_min": {
        "price": 71.25
      },
      "_max": {
        "price": 74.09
      }
    },
    {
      "fuelType": "Motorin",
      "_avg": {
        "price": 81.1
      },
      "_min": {
        "price": 79.45
      },
      "_max": {
        "price": 82.53
      }
    },
    {
      "fuelType": "LPG",
      "_avg": {
        "price": 34.01
      },
      "_min": {
        "price": 32.99
      },
      "_max": {
        "price": 35.93
      }
    }
  ]
}

Şema route kodundaki gerçek yanıtı yansıtır; değerler temsilîdir.

GET/api/prices/nationalHerkese açık (anahtar gerekmez)

EPDK bazlı güncel ulusal fiyatlar; Benzin/Motorin/LPG için sade ve kararlı { fuelType, price, date } şeması. Basit bir site gösterimi için en hafif uç budur.

bash
curl "https://ucuzyakitbul.com.tr/api/prices/national"
Örnek Yanıt
json
{
  "prices": [
    {
      "fuelType": "Motorin",
      "price": 76.35,
      "date": "2026-08-18T00:00:00.000Z"
    },
    {
      "fuelType": "Benzin",
      "price": 69.02,
      "date": "2026-08-18T00:00:00.000Z"
    },
    {
      "fuelType": "LPG",
      "price": 33.64,
      "date": "2026-08-17T00:00:00.000Z"
    }
  ]
}

Şema route kodundaki gerçek yanıtı yansıtır; değerler temsilîdir.

Erişim & Kota Matrisi

Genel API uçlarının tamamı, canlı koddaki gerçek davranışıyla:

EndpointErişimKota / SınırNot
/api/stationsTarayıcıda opsiyonel · tarayıcı-dışında zorunluAnonim: 100/gün (IP) · Anahtarlı: plan kotasıExact GET uçta anahtarsız tarayıcı-dışı istek 403 alır
/api/stations/along-routeTarayıcıda opsiyonel · tarayıcı-dışında zorunluAnonim/plan kotası + herkes için 20 rota/dk (IP)Exact GET uçta anahtarsız tarayıcı-dışı istek 403; bilinmeyen anahtar 401 alır
/api/pricesAPI anahtarı opsiyonelAnonim: 100/gün (IP) · Anahtarlı: plan kotasıUA engeli yok; anahtar kabul edilir ama zorunlu değildir, sunulursa plan kotası uygulanır
/api/prices/nationalHerkese açıkGenel 60/dk (IP)Anahtar gerekmez
/api/stations/{id}API anahtarı opsiyonelGenel middleware: 60/dk (IP) · Anonim: 100/gün (IP) · Anahtarlı: plan kotasıPublic istasyon/fiyat alanlarına liste ucuyla aynı kanonik gösterim bilgilerini ekler; Station.imageUrl ve Google Places credential parametrelerini taşımaz; liste ucuyla aynı kota sözleşmesi ve taze-fiyat penceresi uygulanır; yorumcu tam adı taşımaz. Tarayıcı-dışı erişim UA engeline tabidir
/api/stations/{id}/price-historyHerkese açık (son 2 gün) / premium web oturumu (daha uzun)Herkese açık pencere: son 2 günYayında olmayan istasyonlar 404 döndürür; API anahtarları daha uzun fiyat geçmişi açmaz
/api/healthHerkese açık durum ucuGenel 60/dk (IP)Anonim yanıt yalnız status: ok|fail taşır; operasyonel detaylar internal anahtar gerektirir

Kanonik müşteri-anahtarı kota sözleşmesi /api/stations, /api/prices, /api/stations/along-route ve /api/stations/{id} uçlarında uygulanır. Detay ucu ayrıca validateApiKey öncesinde IP başına 60/dk genel middleware tavanına tabidir; bu nedenle daha yüksek plan dakika kotaları bu uçta pratikte 60/dk ile sınırlanır. API anahtarı detay ucunun tarayıcı-dışı erişim UA engelini kaldırmaz. Fiyat geçmişi ucunun varsayılan/son 2 günlük penceresi oturumsuz herkese açıktır; daha uzun pencere yalnız premium web oturumu ister. API anahtarları daha uzun fiyat geçmişine erişim sağlamaz.

Hata Kodları

KodDurumAçıklama
400Bad RequestGeçersiz veya eksik parametreler
401UnauthorizedSunulan API anahtarı geçersiz (bilinmeyen anahtar)
403ForbiddenAnahtar devre dışı / süresi dolmuş, veya istasyon uçlarına anahtarsız tarayıcı-dışı istemci
429Too Many Requestsİstek limiti aşıldı (detay: İstek Limitleri bölümü)
500Server ErrorSunucu hatası

İstek Limitleri

ErişimGünlük LimitDakikalık LimitFiyat
Anonim (anahtarsız)100 / IP60 / IPÜcretsiz
Starter1.000 / anahtar60 / anahtarÜcretsiz
Pro10.000 / anahtar100 / anahtar990/ay pilot (ilk 5 müşteri) · sonrası ₺1.490/ay
Business100.000 / anahtar1.000 / anahtar2.990/ay

Dakikalık limit, günlük kotayı kısa sürede tüketebilmeniz için tanınan anlık (burst) tavandır ve API anahtarına uygulanır. Anahtarlı kota aşımında 429 yanıtı, ne kadar bekleneceğini belirten Retry-After başlığını taşır. Anahtarsız (anonim) günlük-kota 429 yanıtında Retry-After başlığı bulunmaz.

/api/stations/along-route ayrıca tüm erişim türlerinde IP başına dakikada 20 rota isteğiyle sınırlıdır; pilot dahil hiçbir planın dakikalık limiti bu sağlayıcı-maliyeti tavanını yükseltmez. Bu tavanın 429 yanıtı Retry-After başlığı taşımaz.

Kod Örnekleri

Örnekler yalnızca çalışan davranışı gösterir; API_ANAHTARINIZ yerine size iletilen anahtarı yazın. Tarayıcı-dışı istemciler exact GET /api/stations ve GET /api/stations/along-route uçlarında UA engelini yalnız sunulan API anahtarıyla aşar; anahtarsız istekler 403 alır. GET /api/prices UA engeli olmadan anahtarsız çağrılabilir, müşteri anahtarını da kabul eder ve sunulduğunda plan kotasını uygular. Diğer /api/stations/* alt yollarını API anahtarı tarayıcı-dışı erişime açmaz.

bash
# Şehirdeki istasyonlar (bölge sorgusu)
curl -s -H "x-api-key: API_ANAHTARINIZ" \
  "https://ucuzyakitbul.com.tr/api/stations?city=İstanbul&fuel=Benzin&limit=5"

# Rota boyunca istasyonlar
curl -s -H "x-api-key: API_ANAHTARINIZ" \
  "https://ucuzyakitbul.com.tr/api/stations/along-route?from=İstanbul&to=Ankara&fuelType=Motorin&limit=5"
Fiyatlandırma

İhtiyacına uygun API planını seç

Benzin, Motorin ve LPG verisini kaynak ve tazelik alanlarıyla ürününe bağla. Küçük projeden yüksek hacimli kullanıma kadar net kotalar.

Yıllık seçimde aylık eşdeğer fiyat gösterilir.

Starter

Ücretsiz keşfet

Prototip, kişisel proje ve ilk entegrasyon doğrulaması için.

₺0/ay

Her zaman ücretsiz

Günlük kota1.000
Dakikalık kota60
  • Çalışan API uçlarına erişim
  • Benzin, Motorin ve LPG cevapları
  • Kaynak ve tazelik alanları
  • Küçük proje ve prototip kullanımı
En Popüler
Pro

Ürününe entegre et

Canlı uygulamalar, geliştirici ekipleri ve ticari gösterimler için.

990/ay

Kurucu pilot aylık fiyatı

Pilot sonrası standart fiyat ₺1.490/ay

Günlük kota10.000
Dakikalık kota100
Kurucu Geliştirici Pilotuİlk 5 müşteri

990/ay pilot fiyatı. Başvuru sonrası manuel inceleme; ödeme EFT/banka havalesiyle, fatura e-postayla.

  • Starter'daki her şey
  • Rota üzerindeki en uygun istasyon cevabı
  • Ticari üründe sonuç gösterimi
  • Anahtar bazlı plan kotası
Business

Yüksek hacimle büyü

Yoğun sorgu kullanan şirket ürünleri ve operasyonlar için.

2.990/ay

Aylık faturalama

Günlük kota100.000
Dakikalık kota1.000
  • Pro'daki her şey
  • Yüksek hacimli API kotası
  • Şirket kullanımı için faturalandırma
  • Alan, fiyat özeti ve rota cevapları

Şeffaf sınır: Rota ucu (/api/stations/along-route) tüm planlarda ayrıca IP başına dakikada 20 istekle sınırlıdır; hiçbir planın dakikalık limiti bu tavanı yükseltmez. API anahtarı uzun fiyat geçmişini veya ham veri dışa aktarımını açmaz.

Planlara dahil olmayanlar: ham veya toplu veri aktarımı; veriyi olduğu gibi yeniden satma, başka bir API olarak sunma ya da API'ye proxy'leme; herkese açık pencerenin (son 2 gün) ötesinde fiyat geçmişi. Satılan ürün hesaplanmış yanıtlar ve görüntüleme hakkıdır; toplu veri seti değildir.

Veri kullanım şartı: API verilerini kendi ürün ve hizmetlerinizde ticari olarak kullanabilirsiniz. Veriyi olduğu gibi yeniden satamaz, üçüncü taraflara API olarak sunamazsınız.

Tüm planlarda anahtar, başvuru ve manuel inceleme sonrası e-postayla iletilir. Ücretli planlarda ödeme manuel EFT/banka havalesiyle alınır; fatura e-postayla gönderilir. Sitede otomatik ödeme akışı yoktur.

API Anahtarı Başvurusu

Formu doldurun; başvurular manuel olarak incelenir. Onaylanan başvurularda API anahtarınız e-postayla iletilir. Ücretli planlarda ödeme manuel EFT/banka havalesiyle alınır; havale bilgileri onay e-postasında paylaşılır ve faturanız e-postayla gönderilir. Formu göndermek bir anahtar oluşturmaz veya satın alma gerçekleştirmez.

Özel kota veya kurumsal ihtiyaçlar için doğrudan yazın: destek@ucuzyakitbul.com.tr

API anahtarları yalnızca bu sayfadaki başvuru akışı üzerinden, manuel inceleme sonrası verilir.