RESTful API v1

Türkiye'nin Yakıt Fiyatları API'si

14.988 istasyon, 81 il, günlük güncelleme. 5 dakikada entegre et.

Dokümantasyon

14.988

İstasyon

81 İl

Kapsam

<200ms

Yanıt Süresi

99.9%

Uptime

Quickstart

API Anahtarı Al

Başvuru formunu doldurun. Starter key anında, Pro/Business 24 saat içinde gönderilir.

İlk İsteğini Gönder

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://ucuzyakitbul.com.tr/api/stations?city=İstanbul&limit=3"

Yanıtı İşle

json

{
  "stations": [
    {
      "name": "Shell Kadıköy",
      "brand": "Shell",
      "fuelPrices": [{ "fuelType": "Benzin", "price": 60.98 }]
    }
  ],
  "total": 982,
  "hasMore": true
}

Authentication

API anahtarınızı Authorization veya x-api-key header'ı ile gönderin (ikisi de kabul edilir):

http

Authorization: Bearer YOUR_API_KEY
# veya
x-api-key: YOUR_API_KEY

Key eksik veya geçersizse:

json

{
  "error": "Geçersiz API anahtarı.",
  "status": 401
}

Endpoints

GET/api/stations

İstasyonları listele, filtrele ve sırala

Parametre	Tip	Açıklama
`city`	string	Şehir adı (örn: İstanbul)
`fuel`	string	Yakıt türü: Benzin, Motorin, LPG
`lat, lng`	number	GPS koordinatları
`radius`	number	Arama yarıçapı km (varsayılan: 50)
`sort`	string	Sıralama: price, distance
`limit`	number	Sonuç sayısı (max: 500)
`q`	string	Metin araması

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://ucuzyakitbul.com.tr/api/stations?city=İstanbul&fuel=Benzin&limit=5"

Örnek Yanıt ▾

json

{
  "stations": [
    {
      "id": "cmmon5dbs...",
      "name": "Shell Kadıköy",
      "brand": "Shell",
      "city": "İstanbul",
      "district": "Kadıköy",
      "latitude": 40.9867,
      "longitude": 29.0261,
      "fuelPrices": [
        { "fuelType": "Benzin", "price": 60.98, "source": "EPDK" }
      ]
    }
  ],
  "total": 982,
  "hasMore": true
}

GET/api/stations/:id

Tekil istasyon detayı — fiyatlar, yorumlar, konum

Parametre	Tip	Açıklama
`id`	string	İstasyon CUID (zorunlu)

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://ucuzyakitbul.com.tr/api/stations/cmmon5dbs0000e4mny6ki9pf2"

Örnek Yanıt ▾

json

{
  "id": "cmmon5dbs0000e4mny6ki9pf2",
  "name": "Shell Kadıköy",
  "brand": "Shell",
  "city": "İstanbul",
  "district": "Kadıköy",
  "address": "Caferağa Mah. Moda Cad.",
  "latitude": 40.9867,
  "longitude": 29.0261,
  "is24h": true,
  "phone": "0216 123 45 67",
  "fuelPrices": [
    { "fuelType": "Benzin", "price": 60.98 },
    { "fuelType": "Motorin", "price": 72.67 },
    { "fuelType": "LPG", "price": 29.50 }
  ],
  "avgRating": 4.2,
  "reviewCount": 15
}

GET/api/prices

Türkiye geneli ortalama yakıt fiyatları

bash

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://ucuzyakitbul.com.tr/api/prices"

Örnek Yanıt ▾

json

{
  "benzin": { "avg": 60.77, "min": 59.83, "max": 65.27 },
  "motorin": { "avg": 72.68, "min": 71.56, "max": 78.06 },
  "lpg": { "avg": 29.58, "min": 29.12, "max": 31.77 },
  "updatedAt": "2026-04-10T06:00:00Z"
}

GET/api/v1/stations

EV şarj ağı (Beta) — kW gücü, priz tipi, uygunluk durumu. B2B demo: mock veri, API key gerektirmez.

Parametre	Tip	Açıklama
`fuelType`	string	ev (EV şarj) — diğer türler yakında
`lat, lng`	number	GPS koordinatları (opsiyonel)
`radius`	number	Yarıçap METRE cinsinden (varsayılan: 5000)

bash

curl "https://ucuzyakitbul.com.tr/api/v1/stations?lat=41.0082&lng=28.9784&fuelType=ev&radius=5000"

Örnek Yanıt ▾

json

{
  "version": "v1",
  "fuelType": "ev",
  "radiusMeters": 5000,
  "count": 2,
  "data": [
    {
      "id": "ev-voltrun-beyoglu",
      "name": "Voltrun Taksim",
      "operator": "Voltrun",
      "latitude": 41.036,
      "longitude": 28.977,
      "city": "İstanbul",
      "district": "Beyoğlu",
      "connectorTypes": ["DC", "CCS"],
      "powerKw": 90,
      "status": "active",
      "distance": 3.1
    }
  ],
  "_meta": { "mock": true }
}

Error Codes

Kod	Status	Açıklama
200	OK	İstek başarılı
400	Bad Request	Geçersiz parametreler
401	Unauthorized	API key eksik veya geçersiz
403	Forbidden	Erişim engellendi
429	Too Many Requests	Rate limit aşıldı
500	Server Error	Sunucu hatası

Rate Limits

Plan	Günlük Limit	Fiyat	Aşılırsa
Starter	500	Ücretsiz	429 + Retry-After
Pro	10.000	₺499/ay	429 + Retry-After
Business	100.000	₺1.999/ay	429 + Retry-After
Enterprise	Sınırsız	İletişim	—

Code Samples

bash

curl -s -H "Authorization: Bearer YOUR_API_KEY" \
  "https://ucuzyakitbul.com.tr/api/stations?city=İstanbul&fuel=Benzin&limit=5" | jq .

Pricing

Starter

Ücretsiz

1.000 / gün istek

Tüm endpoint erişimi
JSON format
Topluluk desteği

Popüler

Pro

₺499/ay

10.000 / gün istek

Tüm Starter
Email desteği

Business

₺1.999/ay

100.000 / gün istek

Tüm Pro
Öncelikli email desteği

Enterprise

İletişim

Sınırsız istek

Tüm Business
Özel SLA
Dedike yönetici
Özel entegrasyon

API Anahtarı Başvurusu

Formu doldurun, 24 saat içinde API anahtarınızı email ile gönderelim.

Kurumsal / B2B erişim, EV şarj ağı verisi veya yüksek kota için doğrudan iletişim: destek@ucuzyakitbul.com.tr

Parametre

Tip

Açıklama

city

string

Şehir adı (örn: İstanbul)

fuel

string

Yakıt türü: Benzin, Motorin, LPG

lat, lng

number

GPS koordinatları

radius

number

Arama yarıçapı km (varsayılan: 50)

sort

string

Sıralama: price, distance

limit

number

Sonuç sayısı (max: 500)

q

string

Metin araması

{ "stations": [ { "id": "cmmon5dbs...", "name": "Shell Kadıköy", "brand": "Shell", "city": "İstanbul", "district": "Kadıköy", "latitude": 40.9867, "longitude": 29.0261, "fuelPrices": [ { "fuelType": "Benzin", "price": 60.98, "source": "EPDK" } ] } ], "total": 982, "hasMore": true }

Parametre

Tip

Açıklama

id

string

İstasyon CUID (zorunlu)

{ "id": "cmmon5dbs0000e4mny6ki9pf2", "name": "Shell Kadıköy", "brand": "Shell", "city": "İstanbul", "district": "Kadıköy", "address": "Caferağa Mah. Moda Cad.", "latitude": 40.9867, "longitude": 29.0261, "is24h": true, "phone": "0216 123 45 67", "fuelPrices": [ { "fuelType": "Benzin", "price": 60.98 }, { "fuelType": "Motorin", "price": 72.67 }, { "fuelType": "LPG", "price": 29.50 } ], "avgRating": 4.2, "reviewCount": 15 }

{ "benzin": { "avg": 60.77, "min": 59.83, "max": 65.27 }, "motorin": { "avg": 72.68, "min": 71.56, "max": 78.06 }, "lpg": { "avg": 29.58, "min": 29.12, "max": 31.77 }, "updatedAt": "2026-04-10T06:00:00Z" }

Parametre

Tip

Açıklama

fuelType

string

ev (EV şarj) — diğer türler yakında

lat, lng

number

GPS koordinatları (opsiyonel)

radius

number

Yarıçap METRE cinsinden (varsayılan: 5000)

{ "version": "v1", "fuelType": "ev", "radiusMeters": 5000, "count": 2, "data": [ { "id": "ev-voltrun-beyoglu", "name": "Voltrun Taksim", "operator": "Voltrun", "latitude": 41.036, "longitude": 28.977, "city": "İstanbul", "district": "Beyoğlu", "connectorTypes": ["DC", "CCS"], "powerKw": 90, "status": "active", "distance": 3.1 } ], "_meta": { "mock": true } }

Kod

Status

Açıklama

200

İstek başarılı

400

Bad Request

Geçersiz parametreler

401

Unauthorized

API key eksik veya geçersiz

403

Forbidden

Erişim engellendi

429

Too Many Requests

Rate limit aşıldı

500

Server Error

Sunucu hatası

Plan

Günlük Limit

Fiyat

Aşılırsa

Starter

500

Ücretsiz

429 + Retry-After

Pro

10.000

₺499/ay

429 + Retry-After

Business

100.000

₺1.999/ay

429 + Retry-After

Enterprise

Sınırsız

İletişim

—