● API v1.0 Aktiv

Film Senaryo API

Greifen Sie programmatisch auf Film-, Serien- und Schauspielerdaten zu. Alle Endpunkte liefern JSON.

🔑 API-SchlĂŒssel

Diese API benötigt einen SchlĂŒssel. Senden Sie ihn ausschließlich im Header X-API-Key.

X-API-Key: <API_ANAHTARINIZ>

Allgemeine Regeln

Alle Anfragen nutzen GET. Antworten sehen so aus:

{ "basarili": true, "zaman": "2026-01-15T12:00:00+03:00", "veri": { ... } }
RegelWert
Ratenbegrenzung60 Anfragen pro Minute (pro IP)
Seitennummerierung?page=1&limit=20 — Limit höchstens 100
Cache60 s serverseitig
Formatapplication/json; charset=utf-8

GET /api/site

Website-Info und API-Version

GET /api/filmler

Veröffentlichte Filme und Serien (paginiert)

ParameterTypBeschreibung
turfilm | diziTyp-Filter (film | dizi)
kategoristringKategorie (tĂŒrkisch: Drama, Aksiyon
)
yilintErscheinungsjahr
arastringSuche in Titel oder Genre
sayfaintSeitenzahl (Parameter: page)
limitintDatensÀtze pro Seite (max 100)

Beispiel:

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

GET /api/film/{slug}

Alle Details zu einem Titel: Credits, Wertungen, Besetzung, Kommentare, Pro/Contra

Beispiel:

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

GET /api/oyuncular

Schauspielerliste (paginiert)

ParameterTypBeschreibung
arastringNach Schauspielernamen suchen
sayfaintSeitenzahl (Parameter: page)
limitintDatensÀtze pro Seite

Beispiel:

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

GET /api/oyuncu/{slug}

Schauspieler-Details: Biografie, Wertung, Filmografie

Beispiel:

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

GET /api/turler

Alle Genres mit Titelanzahl

Beispielanfrage (cURL)

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

Hinweis: Kategorien werden tĂŒrkisch gespeichert, z. B. Drama oder Aksiyon. FĂŒr die Seitennummerierung funktionieren sayfa und page.

← ZurĂŒck zur Website