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))
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%
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:
barajis reservoir hydro,akarsurun-of-river hydro,dogalgaznatural gas,linyitlignite,ithal_komurimported coal,ruzgarwind,gunessolar. -
uluslararasiis 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 upkaynaklaryourself, 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
}
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 asKURUHÜ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 ofortalama, and also returnmedyan. 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_kwhtodc_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: nullmeans 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}`);
}
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
(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)