Yarış API

Name: Türkiye Yarış Takvimi Verisi
Creator: Yarış Radarı

Yarış Radarı, Türkiye'deki koşu, patika koşusu, bisiklet, yüzme, triatlon ve HYROX yarışlarını her gün dokuz kaynaktan tarayıp tek takvimde topluyor. Bu sayfadaki okuma amaçlı JSON API aynı veri kümesini uygulamalara açar: tarihler, şehirler ve koordinatlar, branşlar, parkurlar (mesafe, yükseklik kazanımı, ITRA puanı, ücret), kayıt pencereleri ve son kayıt tarihleri, resmi site ve sonuç bağlantıları.

Güncel yarış takvimine ihtiyaç duyan uygulamalar, antrenman platformları ve yayınlar için düşünüldü. Taban adres: https://yarisradari.com/api/v1

Kimlik doğrulama

Her istekte anahtarını iki header'dan biriyle gönder. Anahtarlar sunucular arası kullanım için tasarlandı.

Authorization: Bearer yr_live_xxxxxxxx
X-API-Key: yr_live_xxxxxxxx

GET /races

Filtrelenebilir yarış listesi. Tüm parametreler opsiyonel; csv tipindekiler virgülle birden çok değer alır. distance_min/max verilince dönen distances dizisi sadece eşleşen parkurlara filtrelenir.

Parametre	Tip	Açıklama
scope	csv	local, national, international
sport	csv	road_run, trail_run, cycling, swimming, triathlon, orienteering, hyrox
status	csv	scheduled, tbc, postponed, cancelled, completed
city	metin	Şehir tam eşleşme, büyük/küçük harf duyarsız
q	metin	Yarış adında kısmi arama
from	YYYY-MM-DD	Başlangıç tarihi bu tarihten itibaren
to	YYYY-MM-DD	Başlangıç tarihi bu tarihe kadar
updated_since	ISO tarih/zaman	Sadece bu andan sonra güncellenenler; artımlı senkron için
distance_min	sayı (km)	En az bu mesafede parkuru olan yarışlar
distance_max	sayı (km)	En fazla bu mesafede parkuru olan yarışlar
sort	metin	start_date (varsayılan), -start_date, updated_at, -updated_at
limit	tamsayı	1-100 arası, varsayılan 25
offset	tamsayı	0-10000 arası, sayfalama

curl "https://yarisradari.com/api/v1/races?sport=trail_run&from=2026-09-01&limit=5" \
  -H "Authorization: Bearer yr_live_xxxxxxxx"

Yanıt:

{
  "data": [
    {
      "id": "uuid",
      "slug": "istanbul-maratonu-2026",
      "name": "İstanbul Maratonu",
      "sport": "road_run",
      "scope": "national",
      "status": "scheduled",
      "city": "İstanbul",
      "venue": null,
      "country_code": "TR",
      "start_date": "2026-11-01",
      "end_date": null,
      "latitude": 41.0,
      "longitude": 28.9,
      "website_url": "https://...",
      "results_url": null,
      "description_tr": "...",
      "description_en": null,
      "distances": [
        {
          "label": "Maraton",
          "distance_km": 42.195,
          "elevation_gain_m": null,
          "itra_points": null,
          "price": 1500,
          "currency": "TRY"
        }
      ],
      "registration": [
        {
          "kind": "standard",
          "opens_at": null,
          "closes_at": "2026-10-20T23:59:00+03:00",
          "price": null,
          "currency": "TRY",
          "registration_url": "https://..."
        }
      ],
      "created_at": "...",
      "updated_at": "..."
    }
  ],
  "meta": { "total": 90, "count": 25, "limit": 25, "offset": 0, "request_id": "uuid" }
}

GET /races/{slug}

Tek yarışın detayı, liste ile aynı alan yapısında: { "data": { ... }, "meta": { "request_id": "uuid" } }. Bulunamazsa 404 döner.

JavaScript örneği

const res = await fetch(
  'https://yarisradari.com/api/v1/races?sport=trail_run&distance_min=40',
  { headers: { Authorization: `Bearer ${process.env.YARISRADARI_API_KEY}` } },
)
const { data, meta } = await res.json()

Limitler ve hatalar

Aylık kota ve dakika limiti anahtar bazındadır; kalan hakkını X-Quota-Remaining ve X-RateLimit-Remaining yanıt başlıklarından izleyebilirsin. Her yanıtta log korelasyonu için X-Request-Id bulunur. Hatalar { "error": "kod", "request_id": "uuid" } formatında döner:

HTTP	Kod	Anlamı
400	invalid_scope, invalid_sport, …	Geçersiz parametre
401	missing_api_key / invalid_api_key	Anahtar yok ya da hatalı
404	not_found	Tekil yarış bulunamadı
429	quota_exceeded	Aylık kota bitti
429	rate_limit_exceeded	Dakika limiti aşıldı
503	service_unavailable	Geçici sunucu sorunu, Retry-After başlığına bak

Erişim anahtarı

API erişim anahtarıyla çalışıyor. Kullanmak istersen iletişim sayfasından yazman yeterli; ihtiyacına uygun bir planı birlikte konuşuruz.

Sık sorulan sorular

(4)

Türkiye'deki yarışları tek yerde toplayan bir veri kaynağı var mı?

Yarış Radarı, Türkiye'deki koşu, patika koşusu, bisiklet, yüzme, triatlon ve HYROX yarışlarını federasyon takvimleri, zamanlama platformları ve organizatör sitelerinden her gün otomatik derliyor; dünyanın büyük yarışları da takvimde. Bu API, aynı veri kümesini JSON olarak uygulamalara açar.

Yarış API hangi verileri döndürür?

Tarihler, şehir ve koordinatlar, branş, parkurlar (mesafe, yükseklik kazanımı, ITRA puanı, ücret), kayıt pencereleri ve son kayıt tarihleri, resmi site, kayıt ve sonuç bağlantıları, Türkçe açıklamalar.

Veri ne sıklıkla güncellenir?

Takvim her sabah otomatik taramayla güncellenir; updated_since parametresiyle yalnızca değişen kayıtları çekerek artımlı senkron kurulabilir.

Yarış API ücretsiz mi, nasıl erişilir?

Erişim anahtarla çalışıyor; iletişim sayfasından yazman yeterli, ihtiyacına uygun planı birlikte konuşuruz.