DEV Community

serbay
serbay

Posted on

Turkish energy data for developers: hourly power prices, outages, tariffs and EV chargers

Energy is one of those areas where Turkish data looks simple until you put it on a page. The "electricity price" in
a news story can mean three different numbers. A planned outage list for tomorrow is complete; the one for today
isn't. A fuel price feed gives you a number a few lira below what the pump shows. And about one charging station in
270 has coordinates in a different province from its own address.

I build VeriApi.Pro, a data API for Turkey. This post goes through the energy
side: what each dataset actually measures, the traps we hit while building it, and code you can run. Every number
below comes from the live API on 10 November 2026; the Python and JavaScript ran against it as written.

1. Three different "electricity prices"

What Unit Who pays it
Day-ahead market price (PTF), hourly TL/MWh Suppliers and large consumers buying wholesale
Regulated tariff kuruş/kWh, before taxes Households and small businesses on the default tariff
The bill TL Tariff + taxes and fees, by consumption tier

On 10 November the average day-ahead price was 3,825.62 TL/MWh, which is 3.83 TL/kWh. The regulated
residential tariff for the lower tier (energy + distribution, before taxes) was 291.90 kuruş/kWh, or 2.92 TL/kWh.
So on that day the household tariff was below the wholesale average. Don't compute one from the other.

Day-ahead price: find the cheapest hours

The day-ahead price is set a day in advance, hour by hour, and tomorrow's prices appear in the early afternoon
(yarin_yayimlandi: true in the response once they're out; ask for them with ?tarih=YYYY-MM-DD). If you schedule
anything flexible (EV charging on a business tariff, a water heater, a batch job on your own servers), the cheapest
run of consecutive hours is the useful number:

import json, os, urllib.request

API = "https://api.veriapi.pro"
KEY = os.environ["VERIAPI_KEY"]

def get(path):
    req = urllib.request.Request(API + path, headers={"X-API-Key": KEY, "User-Agent": "energy-demo/1.0"})
    with urllib.request.urlopen(req, timeout=10) as r:
        return json.load(r)["veri"]

def cheapest_window(hours, length):
    """Start hour and average TL/MWh of the cheapest run of `length` consecutive hours."""
    prices = [h["tl"] for h in hours]
    best = min(range(len(prices) - length + 1), key=lambda i: sum(prices[i:i + length]))
    return hours[best]["saat"], sum(prices[best:best + length]) / length

ptf = get("/v1/elektrik/ptf")
start, avg = cheapest_window(ptf["saatler"], 3)
print(f"{ptf['tarih']}: daily average {ptf['ortalama']:.2f} TL/MWh "
      f"({ptf['ortalama'] / 1000:.2f} TL/kWh)")
print(f"Cheapest 3 hours start at {start}: {avg:.2f} TL/MWh")

mix = get("/v1/elektrik/uretim")["son"]
top = sorted(mix["paylar"].items(), key=lambda kv: kv[1], reverse=True)[:3]
print(f"{mix['zaman']}: renewables {mix['yenilenebilir_pay']}%, top sources:",
      ", ".join(f"{k} {v}%" for k, v in top))
Enter fullscreen mode Exit fullscreen mode

Output:

2026-11-10: daily average 3825.62 TL/MWh (3.83 TL/kWh)
Cheapest 3 hours start at 03:00: 2966.66 TL/MWh
2026-11-10T17:00: renewables 46.9%, top sources: baraj 33.9%, dogalgaz 31.2%, linyit 10.8%
Enter fullscreen mode Exit fullscreen mode

The spread that day ran from 2,900 TL/MWh at 04:00 to 4,500 TL/MWh across the evening peak, 16:00–21:00. Each hour
also comes in USD and EUR (usd, eur), which saves you a currency lookup when you compare with European markets.

A few notes on the generation mix:

  • Keys are Turkish: baraj is reservoir hydro, akarsu run-of-river hydro, dogalgaz natural gas, linyit lignite, ithal_komur imported coal, ruzgar wind, gunes solar.
  • uluslararasi is net imports (imports minus exports) and can be negative. It isn't a source, so it's left out of the shares; if you add up kaynaklar yourself, leave it out too.
  • Solar looks tiny in the evening because the figure is for one hour (0.1% at 17:00 in November). For a daily picture, sum the hours or look at midday.

Consumption (/v1/elektrik/tuketim) is hourly and about two hours behind.

Regulated tariff: tiers and time-of-use

/v1/elektrik/tarife returns the current regulator decision in kuruş/kWh, before taxes. What trips people up:

  • Residential has two tiers. Up to a daily average of 8 kWh (about 240 kWh on a 30-day bill) the total is 291.90 kuruş/kWh; the part above that is 432.07. Shops and offices (ticarethane) switch at 30 kWh a day.
  • Time-of-use rates replace the single rate, they don't stack on it: daytime (gunduz), peak (puant) and night (gece) each have their own total.
  • Taxes and fees are not included. The response says so in not; don't show these numbers as "what you'll pay".

Natural gas (/v1/dogalgaz/tarife) works the same way: a wholesale price for homes (10.625 TL/Sm³, also given per kWh)
and a second tier (18 TL/Sm³) once monthly consumption passes a province-specific limit. For November in Istanbul
that limit is 136.01 Sm³. Limits are only listed for the provinces we've verified, and the local distribution charge
isn't included.

2. Outages: tomorrow is complete, today isn't

/v1/elektrik/kesinti lists planned outages for the next 7 days and unplanned ones (faults) for yesterday and
today:

{
  "id": 11066655,
  "tur": "planli",
  "il": "Düzce",
  "plaka": 81,
  "yaka": null,
  "ilce": "Yığılca",
  "baslangic": "2026-11-10T09:00:00",
  "bitis": "2026-11-10T15:00:00",
  "neden": "KESİNTİ ÖNLEME AMAÇLI GENEL BAKIM ONARIM ÇALIŞMASI",
  "mahalleler": ["AVUTLUK KÖYÜ", "KURUHÜSEYİN KÖYÜ", "OSMANCIK KÖYÜ"],
  "etkilenen_abone": 71
}
Enter fullscreen mode Exit fullscreen mode

Things to design around:

  • Unplanned outages are reported after the fact. At the start of a day the unplanned list is nearly empty; yesterday's had about 2,400 entries when we first checked. If you show "outages today", say that unplanned ones may be missing, and keep yesterday's for context.
  • Istanbul has two distribution regions. They come through as "il": "İstanbul" plus "yaka": "Avrupa" or "Asya", so a user in Kadıköy doesn't get European-side outages.
  • Neighbourhood names are free text. Upper case, mixed ASCII and Turkish letters, sometimes no commas between names. One distributor sent the same village twice that morning, once as KURUHÜSEYIN (dotless capital I) and once as KURUHÜSEYİN. We merge those now, keeping the Turkish spelling. If you parse the raw lists yourself, compare names with I and İ folded together, or users will see duplicates and miss matches.
  • Times change. Show the distributor's line (186) next to the list; the response carries that note.

3. Fuel prices are distributor-reported, not pump prices

Fuel prices (/v1/akaryakit?il=istanbul) are what each distributor reports as its dealers' ceiling or suggested
price, per province (Istanbul is split into the Anatolian and European sides). It's close to the pump, but it's a
different number, and the response says so in fiyat_turu. Expect two problems:

  • Bad entries. On 9 November one distributor reported unleaded at 50.13 TL/litre on the Anatolian side, where the other 23 were between 72.37 and 79.22. An average that includes it is wrong. We flag entries more than 25% from the median ("aykiri": true), leave them out of ortalama, and also return medyan. Use the median for a single "price in Istanbul" figure.
  • Stale distributors. A small distributor may not report for weeks. We drop any whose last report is older than 7 days; if you collect the data yourself, do the same.

4. EV chargers: 17,755 stations, and some are in the wrong city

/v1/sarj/* covers every licensed public and private charging station from the regulator's licence registry, with
the operator, address, coordinates and each socket's type and power. As of 10 November:

  • 17,755 stations, 51,460 sockets; 8,632 stations (48.6%) have at least one DC socket.
  • Sockets: Type 2 28,890, CCS2 22,383, CHAdeMO 104.
  • 201 operators; the largest three hold 25% of stations.

Check coordinates against the address. Licence records are filled in by operators. We compared the province in
each address with the province its coordinates fall in: 64 of 17,164 disagree. One station with an address in
Sarayönü, Konya sits at coordinates in Fatih, Istanbul, about 420 km away in a straight line. A "nearest charger" feature will put that one
in front of drivers in Istanbul. Since we can't tell which half is wrong, these records now carry a konum_uyari
object (address province vs coordinate province) and go to the end of nearby and list results, whatever the
distance. If you collect the data yourself, compare the address's last segment (… / KONYA) with the province you
compute from the coordinates, and flag or demote the mismatches.

Prices: AC vs DC, ranges, idle fees

We haven't found an official price feed for charging, so we maintain a table from the operators' own price pages (12 operators
so far, each row with the date we last checked it), attached to every station as tarife and listed at
/v1/sarj/fiyatlar. Three things matter when you show them:

  • DC costs more than AC, and some operators charge by location or power, so a price is often a range (dc_tl_kwh to dc_tl_kwh_en_cok).
  • Idle fees (ek_ucret) can matter more than the kWh price: several operators charge per minute or per block of 15 minutes once charging has finished.
  • kdv_dahil: null means the operator's page doesn't say whether VAT is included. Don't guess.

Here's the cheapest public DC charging near Kızılay, Ankara, for a 60 kWh battery going from 20% to 80%:

const API = "https://api.veriapi.pro";
const headers = { "X-API-Key": process.env.VERIAPI_KEY, "User-Agent": "energy-demo/1.0" };

async function get(path) {
  const res = await fetch(API + path, { headers });
  if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
  return (await res.json()).veri;
}

// Public DC chargers within 5 km of Kızılay, Ankara, with a published tariff
const { istasyonlar } = await get(
  "/v1/sarj/yakin?enlem=39.9208&boylam=32.8541&yaricap=5&dc=true&herkese_acik=true&limit=100"
);
const kwh = 60 * (0.8 - 0.2); // 60 kWh battery, 20% → 80%

const options = istasyonlar
  .filter((s) => s.tarife?.dc_tl_kwh) // operator has a published price
  .map((s) => ({
    name: s.ad,
    operator: s.operator.ad,
    km: s.mesafe_km,
    kw: s.en_yuksek_kw,
    from: s.tarife.dc_tl_kwh,
    upTo: s.tarife.dc_tl_kwh_en_cok,
    idleFee: s.tarife.ek_ucret,
  }))
  .sort((a, b) => a.from - b.from)
  .slice(0, 3);

for (const o of options) {
  const cost = (o.from * kwh).toFixed(0);
  const max = o.upTo ? `–${(o.upTo * kwh).toFixed(0)}` : "";
  console.log(`${o.operator} · ${o.name} · ${o.km} km · ${o.kw} kW · ${cost}${max} TL`);
  if (o.idleFee) console.log(`  idle fee: ${o.idleFee}`);
}
Enter fullscreen mode Exit fullscreen mode

Output (Node 22):

Otopriz · İlci Otel, Çankaya - DC · 1.82 km · 60 kW · 350–500 TL
  idle fee: Şarj bitiminden 15 dk sonra dakikada 5 TL.
Otopriz · CK Hotel, Çankaya DC, AC · 2.65 km · 120 kW · 350–500 TL
  idle fee: Şarj bitiminden 15 dk sonra dakikada 5 TL.
Sharz.Net · FİKRET PETROL ÇANKAYA 1 · 1.49 km · 50 kW · 378–486 TL
Enter fullscreen mode Exit fullscreen mode

(The idle fee reads "5 TL a minute from 15 minutes after charging ends".) Across all 12 operators, the same 36 kWh
DC session ranges from 350 to 536 TL at the lowest listed rate. There's no live availability data, so "nearest" doesn't
mean "free right now".

5. Bonus: road-trip cost from three datasets

Istanbul to Ankara by petrol car:

Part Endpoint Value
Distance /v1/ulasim/mesafe?nereden=istanbul&nereye=ankara 453 km (official table, city centre to city centre)
Motorway toll /v1/ulasim/otoyol Anadolu Otoyolu, Çamlıca–Akıncı, class 1: 338 TL
Fuel /v1/hesapla/yakit?mesafe=453&tuketim=6.5&il=istanbul&yakit=benzin 29.45 litres × 74.72 = 2,200.13 TL

Toll classes go by axles and wheelbase (class 1 is a car under 3.20 m between axles; class 6 is a motorcycle), and
the response lists each class. The fuel calculator uses the province's current average. If you start on the European side, add a Bosphorus bridge (59 TL for a car on the 15 Temmuz
or Fatih Sultan Mehmet bridge, charged in both directions).

Summary

Data Trap
Day-ahead price TL/MWh, wholesale; tomorrow's appears in the early afternoon
Generation mix Hourly; net imports aren't a source
Electricity / gas tariff Before taxes; tiers and time-of-use
Outages Unplanned ones arrive late; Istanbul has two sides; free-text names
Fuel Distributor-reported, not pump; use the median
EV chargers ~0.4% with address and coordinates in different provinces (flagged); price ranges and idle fees

The endpoints used above are listed in the documentation (in Turkish). If you've
built something on Turkish energy data and hit a trap I haven't mentioned, I'd like to hear it in the comments.


Disclosure: this article was written with the help of AI. I checked the facts, and every number and code sample
was run against the live API before publishing.

Top comments (0)