DOKÜMANTASYON · v1.6.0

CineAtlas API

Katalog, kişi, vizyon, seans ve gişe verileri JSON olarak.

Kimlik doğrulama: her istekte X-Api-Key başlığı (ya da ?api_key=).

Sınırlar: Ücretsiz 60 istek/dk, 1000 istek/gün · Premium 600 istek/dk, 50000 istek/gün. Kalan hak yanıt başlıklarında.

Görseller: poster_path / backdrop_path TMDB yoludur; tam adres için https://image.tmdb.org/t/p/w500 önüne eklenir. Bu veriler TMDB ve Wikidata kaynaklıdır; kullanırken kaynak göster.

Temel adreshttps://api.atlas.musapekel.com/api/public/v1

Kimlik doğrulamaX-Api-Key: ANAHTARIN

OpenAPIopenapi.json (Postman, Insomnia ya da Swagger’a içe aktarılabilir)

Hızlı başlangıç

Geliştirici sayfasından ücretsiz bir anahtar oluştur (anahtar yalnızca bir kez gösterilir).
Anahtarını her isteğin X-Api-Key başlığında gönder.
Yanıtlar JSON’dur; listelerde sayfalama bilgisi meta alanındadır.

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/media?type=movie&sort=rating&per_page=10"

Hatalar ve sınırlar

Tüm hatalar aynı biçimde döner: {"error": "açıklama"}. Her yanıtta kalan hakların başlıklarda yer alır: X-RateLimit-Remaining, X-Daily-Remaining, X-Api-Tier.

Kod	Anlamı	Örnek yanıt
`401`	Anahtar yok, geçersiz ya da devre dışı	`{"error":"Geçersiz ya da devre dışı API anahtarı. Anahtarını X-Api-Key başlığında gönder."}`
`403`	Bu uç nokta premium anahtar ister	`{"error":"Bu uç nokta yalnızca premium API anahtarlarına açık.","tier":"free"}`
`404`	Kayıt bulunamadı	`{"error":"Kayıt bulunamadı."}`
`422`	Parametre hatalı	`{"error":"q en az 2 karakter olmalı."}`
`429`	Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)	`{"error":"Dakikalık istek sınırı aşıldı.","retry_after":42}`

GET/media

Yapımları listele

Yayındaki filmler ve diziler, sayfalı. Sıralama ve filtreler birlikte kullanılabilir.

Parametre	Yer	Tür	Açıklama	Örnek
`type`	sorgu	string: movie \| tv	Yapım türü	`movie`
`genre`	sorgu	string	Tür adı (Türkçe, ör. Dram)	`Dram`
`year`	sorgu	integer	Vizyon yılı	`1991`
`sort`	sorgu	string: popular \| rating \| newest \| title	Sıralama	`rating`
`page`	sorgu	integer	Sayfa (1–500)	`1`
`per_page`	sorgu	integer	Sayfa başına kayıt (1–50, varsayılan 20)	`20`

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/media?type=movie&sort=rating&per_page=10"

Örnek yanıt 200

{
  "data": [
    {
      "id": 5,
      "tmdb_id": 10020,
      "media_type": "movie",
      "title": "Güzel ve Çirkin",
      "original_title": "Beauty and the Beast",
      "poster_path": "/hUJ0UvQ5tgE2Z9WpfuduVSdiCiU.jpg",
      "backdrop_path": "/l3lDWoJuKwPhP6kJnwCsUazj7O9.jpg",
      "release_date": "1991-11-13",
      "vote_average": 7.7,
      "genres": [
        "Animasyon",
        "Aile",
        "Fantastik",
        "Romantik"
      ],
      "runtime": 84,
      "overview": "Kendini esrarengiz bir yaratığa dönüşen prensin şatosunda bulan Belle’in hikâyesi.",
      "url": "https://atlas.musapekel.com/movie/5"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 12,
    "per_page": 20,
    "total": 231
  }
}

Diğer yanıtlar: 401 Anahtar yok, geçersiz ya da devre dışı422 Parametre hatalı429 Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)

GET/media/{type}/{id}

Yapım ayrıntısı

Bilgiler, ilk 20 oyuncu, ekip, platformlar ve fragman bağlantıları.

Parametre	Yer	Tür	Açıklama	Örnek
`type` *	yol	string: movie \| tv	movie ya da tv	`movie`
`id` *	yol	integer	Yapım kimliği (CineAtlas)	`5`

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/media/movie/5"

Örnek yanıt 200

{
  "data": {
    "id": 5,
    "tmdb_id": 10020,
    "media_type": "movie",
    "title": "Güzel ve Çirkin",
    "original_title": "Beauty and the Beast",
    "poster_path": "/hUJ0UvQ5tgE2Z9WpfuduVSdiCiU.jpg",
    "backdrop_path": "/l3lDWoJuKwPhP6kJnwCsUazj7O9.jpg",
    "release_date": "1991-11-13",
    "vote_average": 7.7,
    "genres": [
      "Animasyon",
      "Aile",
      "Fantastik",
      "Romantik"
    ],
    "runtime": 84,
    "overview": "Kendini esrarengiz bir yaratığa dönüşen prensin şatosunda bulan Belle’in hikâyesi.",
    "url": "https://atlas.musapekel.com/movie/5",
    "tagline": "Masalların en güzeli.",
    "status": "Released",
    "certification": "G",
    "imdb_id": "tt0101414",
    "providers": [
      "Disney Plus"
    ],
    "trailers": [
      "https://www.youtube.com/watch?v=iurbZwxKFUE"
    ],
    "cast": [
      {
        "person_id": 6,
        "name": "Angela Lansbury",
        "character": "Mrs. Potts (voice)",
        "profile_path": "/hDaUNAw3u0ATHmq3FyUQnE4cIWd.jpg"
      }
    ],
    "crew": [
      {
        "person_id": 31,
        "name": "Gary Trousdale",
        "job": "Yönetmen"
      }
    ]
  }
}

Diğer yanıtlar: 401 Anahtar yok, geçersiz ya da devre dışı404 Kayıt bulunamadı429 Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)

GET/search

Arama

Yapım (başlık ve özgün ad) ve kişi araması. Türkçe harflerde büyük/küçük harf fark etmez.

Parametre	Yer	Tür	Açıklama	Örnek
`q` *	sorgu	string	Arama metni (en az 2 karakter)	`güzel`

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/search?q=g%C3%BCzel"

Örnek yanıt 200

{
  "data": {
    "media": [
      {
        "id": 5,
        "tmdb_id": 10020,
        "media_type": "movie",
        "title": "Güzel ve Çirkin",
        "original_title": "Beauty and the Beast",
        "poster_path": "/hUJ0UvQ5tgE2Z9WpfuduVSdiCiU.jpg",
        "backdrop_path": "/l3lDWoJuKwPhP6kJnwCsUazj7O9.jpg",
        "release_date": "1991-11-13",
        "vote_average": 7.7,
        "genres": [
          "Animasyon",
          "Aile",
          "Fantastik",
          "Romantik"
        ],
        "runtime": 84,
        "overview": "Kendini esrarengiz bir yaratığa dönüşen prensin şatosunda bulan Belle’in hikâyesi.",
        "url": "https://atlas.musapekel.com/movie/5"
      }
    ],
    "people": [
      {
        "id": 6,
        "name": "Angela Lansbury",
        "profile_path": "/hDaUNAw3u0ATHmq3FyUQnE4cIWd.jpg",
        "known_for_department": "Acting"
      }
    ]
  }
}

Diğer yanıtlar: 401 Anahtar yok, geçersiz ya da devre dışı422 Parametre hatalı429 Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)

GET/people/{id}

Kişi

Biyografi, bağlantılar ve tam filmografi (sitede sayfası olmayan yapımlar dahil; o kayıtlarda id null).

Parametre	Yer	Tür	Açıklama	Örnek
`id` *	yol	integer	Kişi kimliği	`6`

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/people/6"

Örnek yanıt 200

{
  "data": {
    "id": 6,
    "name": "Angela Lansbury",
    "profile_path": "/hDaUNAw3u0ATHmq3FyUQnE4cIWd.jpg",
    "known_for_department": "Acting",
    "tmdb_id": 14730,
    "biography": "İngiliz-Amerikalı oyuncu ve şarkıcı.",
    "place_of_birth": "Londra, İngiltere",
    "imdb_id": "nm0001450",
    "birthday": "1925-10-16",
    "deathday": "2022-10-11",
    "links": {
      "imdb": "https://www.imdb.com/name/nm0001450/",
      "tmdb": "https://www.themoviedb.org/person/14730"
    },
    "filmography": [
      {
        "title": "Güzel ve Çirkin",
        "media_type": "movie",
        "tmdb_id": 10020,
        "id": 5,
        "release_date": "1991-11-13",
        "character": "Mrs. Potts (voice)",
        "jobs": []
      },
      {
        "title": "Cinayet Dosyası",
        "media_type": "tv",
        "tmdb_id": 1544,
        "id": null,
        "release_date": "1984-09-30",
        "character": "Jessica Fletcher",
        "jobs": []
      }
    ]
  }
}

Diğer yanıtlar: 401 Anahtar yok, geçersiz ya da devre dışı404 Kayıt bulunamadı429 Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)

GET/upcoming

Yakında vizyonda

Çıkış tarihi gelecekte olan yapımlar, tarihe göre sıralı.

Parametre	Yer	Tür	Açıklama	Örnek
`page`	sorgu	integer	Sayfa	`1`

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/upcoming"

Örnek yanıt 200

{
  "data": [
    {
      "id": 41,
      "tmdb_id": 10020,
      "media_type": "movie",
      "title": "Yeni Film",
      "original_title": "Beauty and the Beast",
      "poster_path": "/hUJ0UvQ5tgE2Z9WpfuduVSdiCiU.jpg",
      "backdrop_path": "/l3lDWoJuKwPhP6kJnwCsUazj7O9.jpg",
      "release_date": "2026-12-09",
      "vote_average": 7.7,
      "genres": [
        "Animasyon",
        "Aile",
        "Fantastik",
        "Romantik"
      ],
      "runtime": 84,
      "overview": "Kendini esrarengiz bir yaratığa dönüşen prensin şatosunda bulan Belle’in hikâyesi.",
      "url": "https://atlas.musapekel.com/movie/5"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 12,
    "per_page": 20,
    "total": 231
  }
}

Diğer yanıtlar: 401 Anahtar yok, geçersiz ya da devre dışı422 Parametre hatalı429 Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)

GET/people/{id}/awards Premium

Kişinin ödülleri

Ödül ve adaylıklar. result: won | nominated. source: manual | wikidata.

Parametre	Yer	Tür	Açıklama	Örnek
`id` *	yol	integer	Kişi kimliği	`6`

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/people/6/awards"

Örnek yanıt 200

{
  "data": [
    {
      "award": "Akademi Ödülleri",
      "category": "En İyi Yardımcı Kadın Oyuncu",
      "year": 1945,
      "result": "nominated",
      "work": "Gaslight",
      "source": "wikidata"
    }
  ]
}

Diğer yanıtlar: 401 Anahtar yok, geçersiz ya da devre dışı403 Bu uç nokta premium anahtar ister404 Kayıt bulunamadı429 Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)

GET/showtimes Premium

Seanslar

Bir günün seansları (varsayılan bugün, İstanbul saati). En fazla 500 kayıt.

Parametre	Yer	Tür	Açıklama	Örnek
`city`	sorgu	string	Şehir	`İstanbul`
`media_id`	sorgu	integer	Yapım kimliği	`5`
`date`	sorgu	string	Tarih (YYYY-AA-GG)	`2026-11-09`

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/showtimes?city=%C4%B0stanbul"

Örnek yanıt 200

{
  "data": [
    {
      "starts_at": "2026-11-10T20:30:00+03:00",
      "format": "2D",
      "language": "Türkçe Dublaj",
      "hall": "Salon 3",
      "price": 180,
      "cinema": {
        "id": 2,
        "name": "Örnek Sinemaları Kadıköy",
        "chain": "Örnek",
        "city": "İstanbul",
        "district": "Kadıköy"
      },
      "media": {
        "id": 5,
        "title": "Güzel ve Çirkin",
        "media_type": "movie"
      }
    }
  ]
}

Diğer yanıtlar: 401 Anahtar yok, geçersiz ya da devre dışı403 Bu uç nokta premium anahtar ister422 Parametre hatalı429 Dakikalık ya da günlük sınır aşıldı (Retry-After başlığına bak)

GET/box-office Premium

Gişe

Haftalık Türkiye gişe listesi. week boşsa en son hafta.

Parametre	Yer	Tür	Açıklama	Örnek
`week`	sorgu	string	Hafta başlangıcı (YYYY-AA-GG)

İstek

curl -s \
  -H "X-Api-Key: ANAHTARIN" \
  "https://api.atlas.musapekel.com/api/public/v1/box-office"

Örnek yanıt 200

{
  "data": [
    {
      "rank": 1,
      "title": "Güzel ve Çirkin",
      "media_id": 5,
      "weekend_gross": 12500000,
      "weekend_admissions": 61000,
      "total_gross": 48000000,
      "total_admissions": 240000,
      "weeks": 3,
      "screens": 410
    }
  ],
  "meta": {
    "week_start": "2026-11-06"
  }
}

Veri modelleri

MediaCard

`id`	integer
`tmdb_id`	integer
`media_type`	string: movie \| tv
`title`	string
`original_title`	string (boş olabilir)
`poster_path`	string (boş olabilir)	TMDB yolu: https://image.tmdb.org/t/p/w500{poster_path}
`backdrop_path`	string (boş olabilir)
`release_date`	string (boş olabilir) (date)
`vote_average`	number
`genres`	string[]
`runtime`	integer (boş olabilir)	Dakika
`overview`	string (boş olabilir)
`url`	string (uri)	Sitedeki sayfası

MediaDetail

`id`	integer
`tmdb_id`	integer
`media_type`	string: movie \| tv
`title`	string
`original_title`	string (boş olabilir)
`poster_path`	string (boş olabilir)	TMDB yolu: https://image.tmdb.org/t/p/w500{poster_path}
`backdrop_path`	string (boş olabilir)
`release_date`	string (boş olabilir) (date)
`vote_average`	number
`genres`	string[]
`runtime`	integer (boş olabilir)	Dakika
`overview`	string (boş olabilir)
`url`	string (uri)	Sitedeki sayfası
`tagline`	string (boş olabilir)
`status`	string (boş olabilir)
`certification`	string (boş olabilir)
`imdb_id`	string (boş olabilir)
`providers`	string[]
`trailers`	string (uri)[]
`cast`	object[]
`crew`	object[]

PersonCard

`id`	integer
`name`	string
`profile_path`	string (boş olabilir)
`known_for_department`	string (boş olabilir)

Person

`id`	integer
`name`	string
`profile_path`	string (boş olabilir)
`known_for_department`	string (boş olabilir)
`tmdb_id`	integer (boş olabilir)
`biography`	string (boş olabilir)
`place_of_birth`	string (boş olabilir)
`imdb_id`	string (boş olabilir)
`birthday`	string (boş olabilir) (date)
`deathday`	string (boş olabilir) (date)
`links`	object
`filmography`	object[]

Award

`award`	string
`category`	string (boş olabilir)
`year`	integer
`result`	string: won \| nominated
`work`	string (boş olabilir)
`source`	string: manual \| wikidata

Showtime

`starts_at`	string (date-time)
`format`	string (boş olabilir)
`language`	string (boş olabilir)
`hall`	string (boş olabilir)
`price`	number (boş olabilir)
`cinema`	object
`media`	object (boş olabilir)

BoxOfficeEntry

`rank`	integer
`title`	string
`media_id`	integer (boş olabilir)
`weekend_gross`	number (boş olabilir)
`weekend_admissions`	integer (boş olabilir)
`total_gross`	number (boş olabilir)
`total_admissions`	integer (boş olabilir)
`weeks`	integer (boş olabilir)
`screens`	integer (boş olabilir)

PageMeta

`current_page`	integer
`last_page`	integer
`per_page`	integer
`total`	integer

Error

`error`	string
`retry_after`	integer
`tier`	string