● API v1.0 Aktif

Film Senaryo API

Film, dizi ve oyuncu verilerine programatik olarak erişin. Tüm uç noktalar JSON döner.

🔑 API Anahtarı

Bu API anahtar gerektirir. Anahtarınızı yalnız X-API-Key istek başlığında gönderin.

X-API-Key: <API_ANAHTARINIZ>

Genel Kurallar

Tüm istekler GET ile yapılır. Yanıtlar bu şekildedir:

{ "basarili": true, "zaman": "2026-01-15T12:00:00+03:00", "veri": { ... } }
KuralDeğer
Hız sınırıDakikada 60 istek (IP başına)
Sayfalama?sayfa=1&limit=20 — limit en fazla 100
ÖnbellekSunucu tarafında 60 sn
Formatapplication/json; charset=utf-8

GET /api/site

Site bilgisi ve API sürümü

GET /api/filmler

Yayındaki film ve dizi listesi (sayfalı)

ParametreTipAçıklama
turfilm | diziTür filtresi (film | dizi)
kategoristringKategori (türkçe: Drama, Aksiyon…)
yilintYapım yılı
arastringBaşlık veya türde arama
sayfaintSayfa numarası (ad: sayfa)
limitintSayfa başına kayıt (max 100)

Örnek:

https://filmsenaryo.com/api/filmler?tur=film&kategori=Drama&limit=5

GET /api/film/{slug}

Tek filmin tüm detayı: künye, puanlar, oyuncular, yorumlar, artılar/eksiler

Örnek:

https://filmsenaryo.com/api/film/esaretin-bedeli-1

GET /api/oyuncular

Oyuncu listesi (sayfalı)

ParametreTipAçıklama
arastringOyuncu adında arama
sayfaintSayfa numarası (ad: sayfa)
limitintSayfa başına kayıt

Örnek:

https://filmsenaryo.com/api/oyuncular?ara=Leo

GET /api/oyuncu/{slug}

Oyuncu detayı: biyografi, puan, filmografisi

Örnek:

https://filmsenaryo.com/api/oyuncu/leonardo-dicaprio

GET /api/turler

Tüm türler ve içerik sayıları

Örnek İstek (cURL)

curl -X "https://filmsenaryo.com/api/filmler?limit=3" \ -H "Accept: application/json" \ -H "X-API-Key: <API_ANAHTARINIZ>"

Not: Kategori değerleri veritabanında Türkçe saklanır, bu yüzden Drama, Aksiyon gibi yazılır. Sayfalama için sayfa (veya page) kullanılabilir.

← Siteye Dön