API Dokümantasyonu — Sismik Harita

Giriş

Sismik Harita API'si, Türkiye ve çevresindeki deprem verilerine JSON formatında erişim sağlar.

Base URL	`https://sismikharita.com`
Format	JSON (UTF-8)
Rate Limit	60 istek/dakika
Kimlik Doğrulama	Gerekmez
CORS	Tüm originlere açık (`*`)

Tüm endpointler ETag ve Cache-Control başlıklarını destekler. Performans için If-None-Match başlığı ile koşullu istekler gönderin.

Deprem Listesi

GET /api.php

Filtreleme parametreleriyle deprem listesi döndürür.

Parametreler

Parametre	Tip	Açıklama	Örnek
date_from	YYYY-MM-DD	Başlangıç tarihi	`2026-03-01`
date_to	YYYY-MM-DD	Bitiş tarihi	`2026-03-28`
min_magnitude	float	Minimum büyüklük	`3.0`
max_magnitude	float	Maksimum büyüklük	`7.0`
sources	string	Kaynak (virgülle ayrılmış: kandilli, afad, usgs)	`kandilli,afad`
limit	int	Sonuç limiti (maks 1000)	`100`

Örnek İstek

# Son 100 deprem (M3.0+)
curl "https://sismikharita.com/api.php?min_magnitude=3.0&limit=100"

Örnek Yanıt

{
  "status": "success",
  "count": 2,
  "earthquakes": [
    {
      "id": 936144,
      "occurred_at": "2026-03-27 08:14:32",
      "latitude": 40.5612,
      "longitude": 36.5734,
      "depth_km": 7.2,
      "magnitude": 4.1,
      "location": "ERBAA (TOKAT)",
      "source": "kandilli"
    },
    {
      "id": 935987,
      "occurred_at": "2026-03-26 22:45:11",
      "latitude": 38.7201,
      "longitude": 29.4138,
      "depth_km": 12.5,
      "magnitude": 3.2,
      "location": "SIMAV (KUTAHYA)",
      "source": "afad"
    }
  ]
}

Deprem Detayı

GET /deprem_api.php

Tek bir depremin detayli bilgilerini dondurur. Kaynak verileri, moment tensor, shakemap ve yakin istasyonlar dahil.

Parametreler

Parametre	Tip	Aciklama	Ornek
id	int	Deprem ID numarasi	`936144`
date	YYYY-MM-DD	Tarih (`slug` ile birlikte)	`2026-03-13`
slug	string	SEO slug (`date` ile birlikte)	`erbaa-tokat-m5-3`

Ya id parametresi ya da date + slug cifti kullanilmalidir.

Ornek Istek

curl "https://sismikharita.com/deprem_api.php?id=936144"

Ornek Yanit

{
  "status": "success",
  "earthquake": {
    "id": 936144,
    "occurred_at": "2026-03-13 09:22:15",
    "latitude": 40.3821,
    "longitude": 36.5412,
    "depth_km": 8.4,
    "magnitude": 5.3,
    "location": "ERBAA (TOKAT)",
    "source": "kandilli",
    "sources": [ ... ],
    "nearby_stations": [ ... ],
    "nearby_quakes": [ ... ],
    "focal_mechanism": null,
    "slug": "erbaa-tokat-m5-3"
  }
}

Hizli Istatistikler

GET /stats_api.php

Veritabanindaki toplam deprem sayisi, bugunun depremleri, ortalama ve maksimum buyukluk.

Ornek Istek

curl "https://sismikharita.com/stats_api.php"

Ornek Yanit

{
  "status": "success",
  "total": 875941,
  "today": 47,
  "avg_magnitude": 2.8,
  "max_magnitude": 7.8
}

Sismik Istasyonlar

GET /station_api.php

AFAD ve Kandilli'ye ait sismik istasyon konumlarini dondurur.

Parametreler

Parametre	Tip	Aciklama	Ornek
source	string	Istasyon kaynagi filtresi	`afad` veya `kandilli`

Ornek Istek

curl "https://sismikharita.com/station_api.php?source=afad"

RSS Beslemesi

GET /rss

Son 50 deprem (M3.0+) RSS 2.0 formatinda, GeoRSS koordinatlariyla birlikte.

Format: RSS 2.0 + GeoRSS namespace
Minimum buyukluk: 3.0
Sonuc limiti: 50
Onbellek: 5 dakika

Ornek Istek

curl "https://sismikharita.com/rss"

RSS beslemesini Feedly, Inoreader veya herhangi bir RSS okuyucuya ekleyerek deprem bildirimlerini takip edebilirsiniz.

Kullanim Kosullari

Ticari olmayan kullanim icin ucretsizdir.
Kaynak gosterimi zorunludur: Veri kaynagi: Sismik Harita (sismikharita.com)
Veriler olduğu gibi sunulur, garanti verilmez.
Dakikada 60 istek sinirina uyulmalidir.
Otomatik sistemlerde User-Agent basligi gonderilmesi tavsiye edilir.

Deprem verileri bilgilendirme amaclidir. Resmi veriler icin AFAD ve Kandilli Rasathanesi web sitelerini ziyaret edin.

Kod Ornekleri

Ana endpoint (/api.php) icin farkli dillerde ornek kullanim:

# Son 50 deprem (M3.0+, son 7 gun)
curl -s "https://sismikharita.com/api.php?\
  min_magnitude=3.0&\
  date_from=2026-03-20&\
  date_to=2026-03-27&\
  limit=50" | python3 -m json.tool

# ETag ile kosullu istek (304 destegi)
curl -s -H "If-None-Match: \"abc123\"" \
  -w "\nHTTP Status: %{http_code}\n" \
  "https://sismikharita.com/api.php"

async function getEarthquakes() {
  const params = new URLSearchParams({
    min_magnitude: '3.0',
    date_from: '2026-03-20',
    date_to: '2026-03-27',
    limit: '50'
  });

  const response = await fetch(
    `https://sismikharita.com/api.php?${params}`
  );

  if (!response.ok) {
    throw new Error(`HTTP ${response.status}`);
  }

  const data = await response.json();
  console.log(`${data.count} deprem bulundu`);

  for (const eq of data.earthquakes) {
    console.log(
      `M${eq.magnitude} - ${eq.location} (${eq.occurred_at})`
    );
  }
}

getEarthquakes();

import requests

# Son 50 deprem (M3.0+)
response = requests.get(
    "https://sismikharita.com/api.php",
    params={
        "min_magnitude": 3.0,
        "date_from": "2026-03-20",
        "date_to": "2026-03-27",
        "limit": 50,
    },
    headers={"User-Agent": "MyApp/1.0"}
)
response.raise_for_status()

data = response.json()
print(f"{data['count']} deprem bulundu")

for eq in data["earthquakes"]:
    print(
        f"M{eq['magnitude']} - {eq['location']} "
        f"({eq['occurred_at']})"
    )