● API v1.0 Live

Film Senaryo API

Access movie, series and actor data programmatically. Every endpoint returns JSON.

🔑 API Key

This API requires a key. Send your key only in the X-API-Key request header.

X-API-Key: <API_ANAHTARINIZ>

General Rules

All requests use GET. Responses look like this:

{ "basarili": true, "zaman": "2026-01-15T12:00:00+03:00", "veri": { ... } }
RuleValue
Rate limit60 requests per minute (per IP)
Pagination?page=1&limit=20 — limit up to 100
Cache60 s server-side
Formatapplication/json; charset=utf-8

GET /api/site

Site info and API version

GET /api/filmler

Published movies and series (paginated)

ParameterTypeDescription
turfilm | diziType filter (film | dizi)
kategoristringCategory (Turkish: Drama, Aksiyon…)
yilintRelease year
arastringSearch in title or genre
sayfaintPage number (param: page)
limitintRecords per page (max 100)

Example:

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

GET /api/film/{slug}

Full details for one title: credits, ratings, cast, comments, pros/cons

Example:

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

GET /api/oyuncular

Actor list (paginated)

ParameterTypeDescription
arastringSearch by actor name
sayfaintPage number (param: page)
limitintRecords per page

Example:

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

GET /api/oyuncu/{slug}

Actor details: biography, rating, filmography

Example:

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

GET /api/turler

All genres with title counts

Example Request (cURL)

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

Note: category values are stored in Turkish, so they look like Drama or Aksiyon. For pagination you can use sayfa or page.

← Back to site