Geliştirici API

MacEkran Genel API, Türkiye spor TV yayın rehberi verisine açık ve anahtarsız REST erişimi sunar. Bir maçın hangi kanalda yayınlandığını, takım/lig/kanal varlıklarını ve aramayı uygulamanıza entegre edebilirsiniz. Tüm uçlar JSON döner ve CORS açıktır.

Temel adres

https://macekran.com/api/v1

Kimlik doğrulama ve kullanım

Şu an API anahtarı gerekmez — uçlar herkese açıktır.
Adil kullanım: dakikada ~60 isteği aşmayın, yanıtları makul süre önbelleğe alın. Aşırı trafik IP bazında kısıtlanabilir.
Yüksek hacim, ayrılmış kota veya anahtarlı erişim için: [email protected].

Uçlar

Metod	Yol	Açıklama
`GET`	`/matches`	Tarihe göre maçlar
`GET`	`/matches/{id}`	Maç detayı
`GET`	`/teams/{slug}`	Takım bilgisi
`GET`	`/teams/{slug}/matches`	Takımın maçları (yaklaşan + son)
`GET`	`/leagues/{slug}`	Lig bilgisi
`GET`	`/leagues/{slug}/matches`	Ligin maçları
`GET`	`/channels/{slug}`	Kanal bilgisi
`GET`	`/channels/{slug}/matches`	Kanalın bugünkü yayınları
`GET`	`/search`	Takım, lig, kanal, oyuncu ve maç araması

Örnek

Bugünün Süper Lig maçları ve yayın kanalları:

curl "https://macekran.com/api/v1/matches?date=2026-06-22&league=super-lig"

[
  {
    "id": 1234,
    "slug": "fenerbahce-galatasaray-2026-06-22",
    "kickoffAt": "2026-06-22T16:00:00.000Z",
    "status": "scheduled",
    "home": { "slug": "fenerbahce", "name": "Fenerbahçe" },
    "away": { "slug": "galatasaray", "name": "Galatasaray" },
    "league": { "slug": "super-lig", "name": "Süper Lig" },
    "broadcasts": [
      { "channel": { "slug": "bein-sports-1", "name": "beIN Sports 1" },
        "country": "TR", "verifiedBy": "manual" }
    ]
  }
]

OpenAPI spesifikasyonu

Tüm uçların makine-okunabilir tanımı OpenAPI 3.1 formatındadır. Swagger UI, Postman veya istemci-üreteçlerine doğrudan içe aktarabilirsiniz:

https://macekran.com/gelistirici/openapi.json

openapi.json

Kapsam ve lisans

API yalnızca MacEkran'ın kendi ürettiği yayın/program/varlık verisini sunar; üçüncü taraf sağlayıcılardan gelen lisanslı istatistikler (skor, oyuncu/diziliş) public API'de yer almaz. Veriler CC BY 4.0 ile sunulur; kaynak gösterimi zorunludur. Toplu indirme için açık veri sayfasına bakın.