Scraper API

API üç veri ailesi sunar: döviz/altın, akaryakıt ve haberler. Hepsi salt-okunur — bu API üzerinden veri yazılmaz, silinmez.

• Güncel değer — bir şehir + ürün için son kayıt. Varsayılan davranış.
• Zaman serisi — history=true ya da *-history uçları; grafik için hazır.
• Haberler — son 14 günün süzülmüş başlıkları, özetleri ve görselleri.

Tüm istekler https://comboxdev.com/scraper önekiyle yapılır. Yollar bu önekin arkasına eklenir.

curl -s "https://comboxdev.com/scraper/api/currency" \
  -H "X-API-Key: sk_…"

Veriler beş saatte bir toplanır, yani "güncel" değer en fazla bir toplama turu kadar eskiyebilir. Her kayıtta scraped_at alanı vardır.

Okuma uçları X-API-Key başlığı ister. Anahtarlar sk_ önekiyle üretilir ve sahibi tarafından arşiv panelinin Yönetim bölümünden verilir.

GET /scraper/api/fuel?city=Hatay&fuel_type=benzin
X-API-Key: sk_…

Anahtar yalnızca üretildiği anda bir kez gösterilir. Kaybolursa yenisini isteyin; eski anahtar iptal edilir.

Anahtarsız

X-API-Key ile

/api/fuel ve /api/currency aynı filtreleri kabul eder; type değerini kendileri sabitler. /api/data ikisini birlikte döner.

Geçerli olduğu yerler: /api/data, /api/currency, /api/fuel.

Zaman aralıkları

*-history uçlarında range: 3d, 1w, 1m (varsayılan), 1y. Tanınmayan değer 1m'e düşer.

Seride boş gün yoktur: her ürün için son bilinen değer ileri taşınır, böylece grafik çizgisi kopmaz. latest=true ise yalnızca son değer döner ve aynı ürünün eski satırları elenir.

Döviz / altın kaydı

{
  "success": true,
  "count": 3,
  "data": [
    {
      "type": "currency",
      "name": "Dolar",
      "price": 41.8271,
      "currency": "TRY",
      "scraped_at": "2026-10-22 14:00:11"
    }
  ]
}

Akaryakıt kaydı

{
  "type": "fuel",
  "city": "Hatay",
  "district": "Payas",
  "fuel_type": "motorin",
  "product_name": "Motorin",
  "price": 54.31,
  "currency": "TRY",
  "unit": "litre",
  "scraped_at": "2026-10-22 14:00:09"
}

Zaman serisi

{
  "success": true,
  "range": "1w",
  "city": "Hatay",
  "count": 7,
  "series": [
    { "day": "2026-10-16", "benzin": 52.10, "motorin": 54.31 }
  ]
}

Fiyat uçları { success, count, data } ya da { success, range, count, series } sarmalayıcısını kullanır. Haber uçları düz dizi döner. Kaynağın kendi adresi ve markası yanıtlarda yer almaz; yalnızca ürün, yer ve fiyat bilgisi döner.

Yardımcı uçlar

/api/news kimlik doğrulaması istemez ve son 14 günün süzülmüş haberlerini döner. Her turda en fazla 30 haber seçilir; özet ve kategori Türkçe üretilir.

[
  {
    "title": "…",
    "link": "https://…",
    "source": "AA",
    "category": "ekonomi",
    "summary": "…",
    "image": "https://…",
    "pubDate": "2026-10-22T09:12:00.000Z"
  }
]

category=genel "tümü" anlamına gelir. Görsel bulunamazsa image alanı yanıtta hiç yer almaz — alanı zorunlu saymayın.

• Dakikada 240 istek — istemci IP başına. Aşılırsa 429 ve Retry-After başlığı döner.
• limit üst sınırı — veri uçlarında 5000, kayıt sayfasında 200, haberde 100.
• Haber penceresi — 14 gün; daha eski haberler yayında tutulmaz.
• Yazma yok — tüm uçlar GET; veri değiştiren bir yol yoktur.

Hata yanıtları her zaman { success: false, error: "…" } biçimindedir.

# servis ayakta mı
curl -s https://comboxdev.com/scraper/health

# güncel dolar
curl -s "https://comboxdev.com/scraper/api/currency?site=Dolar" \
  -H "X-API-Key: sk_…"

# Hatay'daki benzin ve motorin
curl -s "https://comboxdev.com/scraper/api/fuel?city=Hatay" \
  -H "X-API-Key: sk_…"

# son 7 günün akaryakıt serisi (grafik)
curl -s "https://comboxdev.com/scraper/api/fuel-history?range=1w&city=Hatay" \
  -H "X-API-Key: sk_…"

# doların tüm geçmişi
curl -s "https://comboxdev.com/scraper/api/currency?site=Dolar&history=true&limit=500" \
  -H "X-API-Key: sk_…"

# son ekonomi haberleri (anahtarsız)
curl -s "https://comboxdev.com/scraper/api/news?category=ekonomi&limit=10"

const res = await fetch(
  'https://comboxdev.com/scraper/api/fuel?city=Hatay&fuel_type=benzin',
  { headers: { 'X-API-Key': process.env.SCRAPER_API_KEY } }
);
if (!res.ok) throw new Error(`scraper ${res.status}`);
const { data } = await res.json();

for (const row of data) {
  console.log(row.district, row.price);
}

Fiyatlar sayı olarak (54.31), tarihler veritabanı biçiminde (YYYY-MM-DD HH:mm:ss, UTC) döner. Tarihleri ayrıştırırken saat dilimini kendiniz ekleyin.