temsor API
← Zaman Serisi

Türkiye Akaryakıt Fiyatları

81 ilin benzin, motorin ve yakıt fiyatları — geçmiş bir tarihte yürürlükte olan fiyat dahil.

POST /v1/tr/fuel/prices · 2 kredi

  • Bu sayfadaki her ucu hesap açmadan deneyebilirsiniz.
  • Deterministik uçlar önbellekten tek haneli milisaniyede yanıtlar.
  • Her yanıt bir fiş taşır: harcanan kredi, önbellek durumu, süre.
Bir ucu dene Şemayı oku
POST/v1/tr/fuel/prices 
{}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.
1uç nokta
—biriken veri noktası
—zaman serisi
—ortanca yanıt

Neden var

Düşman girdi için tasarlandı

Türkçe adres "Cd." de olur "Cad." da "Caddesi" de; daire numarası bina numarasına yapışık gelir. Genel ayrıştırıcılar yarısını sessizce düşürür. Bu, yerleştiremediğini size söyler.

Tarihçe sonradan üretilemez

Kur arşivi her iş günü büyüyor ve her nokta kaynak URL’i ile içerik özetini saklıyor. Rakip bugünün bültenini okuyabilir — geçen çeyreği üretemez.

Yalnız yapılan işe ödersiniz

Tekrarlanan girdi önbellekten gelir, sıfır kredi yakar. Bir yanıt kendi şemasına uymazsa çağrı otomatik iade edilir.

Uç noktalarparametreleri görmek ve canlı çağırmak için satırı açın

Zaman Serisi1

/v1/tr/fuel/prices Türkiye Akaryakıt Fiyatları 2 kredi

81 ilin benzin, motorin ve yakıt fiyatları — geçmiş bir tarihte yürürlükte olan fiyat dahil.

Bugünün pompa fiyatı zaten açık bir sayfada; arşivi değil. Bu uç asıl para eden soruyu yanıtlar: 12 Mart'ta Ankara'da motorin kaç liraydı? `asOf` ile o gün yürürlükte olan fiyat döner — o gün zam/indirim yoksa bir önceki fiyat taşınır, `effectiveFrom` başlangıcını söyler ve `carriedForward: true` işaretlenir. `from`/`to` ile aralıktaki değişimler yüzde farkıyla listelenir. Her değer, okunduğu sayfanın URL'i ve içerik özetiyle saklanır; yıllar sonra denetimde savunulabilir. `province` boş bırakılırsa kapsam listelenir.

Parametreler

province string | number Province name or plate code — "Ankara", "istanbul" or 34. Leave empty to list covered provinces.
product "benzin" | "motorin" | "motorin_ekstra" | "gazyagi" | "kalorifer" | "fueloil" | "fueloil_yk" Fuel product. Omitted → every product available for that province.
asOf string Price in force on this date (YYYY-MM-DD). Omitted → latest known price.
from string With `to`: return the price changes in this window.
to string
includeDistricts boolean Adds districts whose pump price differs from the province reference price. varsayılan false
POST/v1/tr/fuel/prices 
{}
henüz istek gönderilmedi
Çalıştır’a basınca tarayıcınızdan canlı API çağrılır.

Fiyatlandırmatek anahtar tüm uçları kapsar

Free
Ücretsiz
kredi
2,000
Hız sınırı
2/s
Hemen dene
Starter
$19/ay
kredi
50,000
Hız sınırı
10/s
en çok seçilen
Pro
$79/ay
kredi
300,000
Hız sınırı
30/s
Scale
$299/ay
kredi
2,000,000
Hız sınırı
100/s

Kredi çağrı başına düşer, önbellekten gelen yanıt ücretsizdir. Anahtarsız istekler IP başına dar bir demo kotasıyla çalışır; kaydolmadan değerlendirebilirsiniz.

API anahtarı ödeme onaylanır onaylanmaz e-postayla gelir. Plan yükseltmede anahtar DEĞİŞMEZ, entegrasyonunuz kırılmaz.

Yapay zekâ asistanından kullanaynı katalog, MCP aracı olarak

Her uç aynı zamanda Model Context Protocol üzerinden yayınlanıyor; Claude, ChatGPT ya da kendi ajanınız doğrudan çağırabilir — ara kod yok, sarmalayıcı fonksiyon yok. Asistan aynı girdi şemalarını ve aynı ölçümü görür.

Şu an 13 araç. Yeni uçlar kendiliğinden görünür; sizin tarafınızda güncellenecek bir şey yok.

claude_desktop_config.json

{
  "mcpServers": {
    "temsor": {
      "url": "https://api.temsor.com/mcp",
      "headers": { "x-api-key": "fk_live_…" }
    }
  }
}

Hızlı başlangıç

Resmî istemci: npm install temsor-api · npmjs.com/package/temsor-api

Node.js

import Client from "temsor-api";

const api = new Client({ apiKey: KEY });
const r = await api.${(() => {
  const first = apis[0];
  return first.slug.split(/[/-]/).map((p, i) => (i === 0 ? p : p[0].toUpperCase() + p.slice(1))).join('');
})()}(${esc(JSON.stringify(apis[0].examples[0]?.input ?? {}))});
console.log(r, r.$meta);

cURL

curl -s https://api.temsor.com/v1/tr/fuel/prices \
  -H "content-type: application/json" \
  -H "x-api-key: fk_live_…" \
  -d '{}'

JavaScript

const res = await fetch("https://api.temsor.com/v1/tr/fuel/prices", {
  method: "POST",
  headers: { "content-type": "application/json", "x-api-key": KEY },
  body: JSON.stringify({})
});
const { data } = await res.json();

Python

import httpx
r = httpx.post("https://api.temsor.com/v1/tr/fuel/prices",
    headers={"x-api-key": KEY},
    json={})
data = r.json()["data"]