● API v1.0 En service

Film Senaryo API

Accédez aux données de films, séries et acteurs par programme. Tous les points de terminaison renvoient du JSON.

🔑 Clé d’API

Cette API nécessite une clé. Envoyez-la uniquement dans l’en-tête X-API-Key.

X-API-Key: <API_ANAHTARINIZ>

Règles générales

Toutes les requêtes utilisent GET. Les réponses ressemblent à ceci :

{ "basarili": true, "zaman": "2026-01-15T12:00:00+03:00", "veri": { ... } }
RègleValeur
Limite de débit60 requêtes par minute (par IP)
Pagination?page=1&limit=20 — limite : 100 max
Cache60 s côté serveur
Formatapplication/json; charset=utf-8

GET /api/site

Infos du site et version de l’API

GET /api/filmler

Films et séries publiés (paginé)

ParamètreTypeDescription
turfilm | diziFiltre de type (film | dizi)
kategoristringCatégorie (turc : Drama, Aksiyon…)
yilintAnnée de sortie
arastringRecherche dans le titre ou le genre
sayfaintNuméro de page (paramètre : page)
limitintEnregistrements par page (max 100)

Exemple :

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

GET /api/film/{slug}

Tous les détails d’un titre : générique, notes, casting, commentaires, plus/moins

Exemple :

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

GET /api/oyuncular

Liste d’acteurs (paginée)

ParamètreTypeDescription
arastringRechercher par nom d’acteur
sayfaintNuméro de page (paramètre : page)
limitintEnregistrements par page

Exemple :

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

GET /api/oyuncu/{slug}

Détails d’un acteur : biographie, note, filmographie

Exemple :

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

GET /api/turler

Tous les genres avec le nombre de titres

Exemple de requête (cURL)

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

Remarque : les catégories sont stockées en turc, par exemple Drama ou Aksiyon. Pour la pagination, sayfa et page fonctionnent tous deux.

← Retour au site