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-routeUygulamana 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/stationsPazar / 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/pricesHızlı Başlangıç
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.
curl "https://ucuzyakitbul.com.tr/api/prices/national"
API Anahtarı Alın
Başvuru formunu doldurun. Başvurular manuel olarak incelenir; onaylanan başvurular için anahtarınız e-postayla iletilir.
İlk İsteğinizi Gönderin
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):
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
/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.
| Parametre | Tip | Açıklama |
|---|---|---|
city | string | Boş olmayan şehir adı (örn: İstanbul) |
fuel | string | Yakıt türü: Benzin, Motorin, LPG |
lat, lng | number | Birlikte verilmesi gereken sonlu GPS koordinatları |
radius | number | Arama yarıçapı km (varsayılan: 50) |
sort | string | Sıralama: price, distance, quality |
limit | integer | Pozitif sonuç sayısı (etkin üst sınır: 500; varsayılan: 20) |
offset | integer | Başlangıç konumu (0-1000; varsayılan: 0) |
q | string | Tam resmi il, ilçe veya il+ilçe sorgusunda yapılandırılmış coğrafya filtresi; diğer girdilerde istasyon/marka serbest metin araması |
curl -H "x-api-key: API_ANAHTARINIZ" \ "https://ucuzyakitbul.com.tr/api/stations?city=İstanbul&fuel=Benzin&limit=5"
Örnek Yanıt
{
"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.
/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.
| Parametre | Tip | Açıklama |
|---|---|---|
from, to | string | Başlangıç ve varış şehri (ikisi birlikte) |
fromLat, fromLng | number | Başlangıç koordinatları (şehir adlarına alternatif) |
toLat, toLng | number | Varış koordinatları (şehir adlarına alternatif) |
fuelType | string | Yakıt türü: Benzin, Motorin, LPG (varsayılan: Benzin) |
radius | number | Rota koridoru km (1-100, varsayılan: 20) |
limit | number | Önerilecek durak sayısı (1-20, varsayılan: 5) |
presetKm | number | Bilinen rota mesafesi km (opsiyonel) |
curl -H "x-api-key: API_ANAHTARINIZ" \ "https://ucuzyakitbul.com.tr/api/stations/along-route?from=İstanbul&to=Ankara&fuelType=Motorin"
Örnek Yanıt
{
"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.
/api/pricesAnahtar opsiyonelYalnı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.
curl -H "x-api-key: API_ANAHTARINIZ" \ "https://ucuzyakitbul.com.tr/api/prices"
Örnek Yanıt
{
"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.
/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.
curl "https://ucuzyakitbul.com.tr/api/prices/national"
Örnek Yanıt
{
"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:
| Endpoint | Erişim | Kota / Sınır | Not |
|---|---|---|---|
/api/stations | Tarayıcıda opsiyonel · tarayıcı-dışında zorunlu | Anonim: 100/gün (IP) · Anahtarlı: plan kotası | Exact GET uçta anahtarsız tarayıcı-dışı istek 403 alır |
/api/stations/along-route | Tarayıcıda opsiyonel · tarayıcı-dışında zorunlu | Anonim/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/prices | API anahtarı opsiyonel | Anonim: 100/gün (IP) · Anahtarlı: plan kotası | UA engeli yok; anahtar kabul edilir ama zorunlu değildir, sunulursa plan kotası uygulanır |
/api/prices/national | Herkese açık | Genel 60/dk (IP) | Anahtar gerekmez |
/api/stations/{id} | API anahtarı opsiyonel | Genel 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-history | Herkese açık (son 2 gün) / premium web oturumu (daha uzun) | Herkese açık pencere: son 2 gün | Yayında olmayan istasyonlar 404 döndürür; API anahtarları daha uzun fiyat geçmişi açmaz |
/api/health | Herkese açık durum ucu | Genel 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ı
| Kod | Durum | Açıklama |
|---|---|---|
| 400 | Bad Request | Geçersiz veya eksik parametreler |
| 401 | Unauthorized | Sunulan API anahtarı geçersiz (bilinmeyen anahtar) |
| 403 | Forbidden | Anahtar devre dışı / süresi dolmuş, veya istasyon uçlarına anahtarsız tarayıcı-dışı istemci |
| 429 | Too Many Requests | İstek limiti aşıldı (detay: İstek Limitleri bölümü) |
| 500 | Server Error | Sunucu hatası |
İstek Limitleri
| Erişim | Günlük Limit | Dakikalık Limit | Fiyat |
|---|---|---|---|
| Anonim (anahtarsız) | 100 / IP | 60 / IP | Ücretsiz |
| Starter | 1.000 / anahtar | 60 / anahtar | Ücretsiz |
| Pro | 10.000 / anahtar | 100 / anahtar | ₺990/ay pilot (ilk 5 müşteri) · sonrası ₺1.490/ay |
| Business | 100.000 / anahtar | 1.000 / anahtar | ₺2.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.
# Ş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"
İ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.
Ürününe entegre et
Canlı uygulamalar, geliştirici ekipleri ve ticari gösterimler için.
Kurucu pilot aylık fiyatı
Pilot sonrası standart fiyat ₺1.490/ay
₺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ı
Ş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.