{"service": "Türkiye Sinema Arama API", "description": "Türkiye'deki sinema zincirlerinin güncel seans, film ve salon verilerini sorgular. AI agent'lar için tasarlandı: SQL yok, sadece GET/POST /api/search + filtreler.", "how_to_use": ["1. AI asistan notu: web sayfası açabiliyorsan bu API'yi kullanabilirsin — aşağıdaki GET URL'lerini normal bir link gibi aç, cevap düz JSON. Anahtar/auth/header gerekmez.", "2. Göreli tarihleri çöz: bugün = meta.time.today, yarın = meta.time.tomorrow (Europe/Istanbul).", "3. Filtre değerlerini meta'dan seç (cities, genres, age_ratings...).", "4. GET /api/search?type=sessions&... veya POST /api/search ile ara.", "5. Sonuçtaki session.booking_url bilet sayfasına gider."], "time": {"now": "2026-08-01T21:09", "today": "2026-08-01", "tomorrow": "2026-08-02", "weekday": "Saturday", "timezone": "Europe/Istanbul (UTC+3)"}, "endpoints": {"GET /": "Bu belge — servis tanımı + canlı meta (Accept: text/html gönderen tarayıcılar arayüzü alır)", "GET /llms.txt": "Bu API'nin insan-okur/AI-okur markdown özeti", "GET /openapi.json": "OpenAPI 3.1 spesifikasyonu (alias: /swagger)", "GET /api/meta": "Mevcut filtre değerleri (şehirler, türler, formatlar, yaş sınırları, tarih aralığı, sayılar)", "GET /health": "Scraper sağlık durumu — son çalışma, bayat veri ve zincir hataları (cache'lenmez)", "GET /api/search": "Arama — filtreler query string olarak (?type=sessions&city=Istanbul&date=...)", "POST /api/search": "Arama — filtreler JSON body olarak: {\"type\": \"sessions\", \"filters\": {...}}"}, "search": {"params": {"type": "sessions | movies | theaters (varsayılan: sessions)", "city": "şehir adı — meta.cities listesinden", "side": "anadolu | avrupa — yalnızca İstanbul için (city vermeye gerek yok)", "genre": "tek tür adı, kısmi eşleşme — meta.genres listesinden (örn. 'Komedi'). Birden çok tür için ayrı sorgular yap.", "movie": "film adı (kısmi eşleşme, Türkçe veya orijinal ad)", "theater": "salon adı (kısmi eşleşme)", "date": "YYYY-MM-DD — tek gün", "date_from": "YYYY-MM-DD — başlangıç", "date_to": "YYYY-MM-DD — bitiş", "time_from": "HH:MM — bu saatten sonraki seanslar", "time_to": "HH:MM — bu saatten önceki seanslar", "format": "2D | 3D", "language": "Altyazılı | Dublaj", "age_rating": "tam eşleşme — meta.age_ratings listesinden (örn. '13+')", "age_rating_max": "sayısal yaş sınırı — çocuklar için bunu kullan (örn. 11 → 11 yaş ve altına uygun filmler; sınırı bilinmeyenler de dahil edilir)", "limit": "max sonuç sayısı (varsayılan 100, max 1000)"}, "notes": ["Sonuçlarda format/language null olabilir — bilinmiyor demektir, elemek için sebep değil.", "Çocuklar için: age_rating_max + genre (Animasyon / Aile / Komedi / Macera) kombinasyonu en iyi sonucu verir.", "side filtresi sadece İstanbul salonları için anlamlıdır (anadolu = Asya yakası, avrupa = Avrupa yakası)."], "get_examples": ["https://cinema.siberofis.com/api/search?type=sessions&side=anadolu&date=2026-08-02&time_from=14:00&genre=Animasyon&age_rating_max=11", "https://cinema.siberofis.com/api/search?type=sessions&city=Istanbul&side=avrupa&date=2026-08-01&language=Altyazılı", "https://cinema.siberofis.com/api/search?type=movies&genre=Komedi", "https://cinema.siberofis.com/api/search?type=theaters&city=Ankara"], "post_examples": [{"type": "sessions", "filters": {"side": "anadolu", "date": "2026-08-02", "time_from": "14:00", "genre": "Animasyon", "age_rating_max": 11}}, {"type": "movies", "filters": {"genre": "Komedi"}}, {"type": "theaters", "filters": {"city": "Ankara"}}]}, "meta": {"time": {"now": "2026-08-01T21:09", "today": "2026-08-01", "tomorrow": "2026-08-02", "weekday": "Saturday", "timezone": "Europe/Istanbul (UTC+3)"}, "cities": ["Adana", "Afyonkarahisar", "Ankara", "Antalya", "Aydın", "Bolu", "Bursa", "Denizli", "Diyarbakır", "Edirne", "Erzurum", "Eskişehir", "Gaziantep", "Hatay", "Istanbul", "Kahramanmaraş", "Kayseri", "Kocaeli", "Konya", "Kütahya", "Kırklareli", "Kırıkkale", "Manisa", "Mersin", "Muğla", "Osmaniye", "Sakarya", "Samsun", "Tekirdağ", "Trabzon", "Van", "Zonguldak", "Çanakkale", "Çorum", "İzmir", "Şanlıurfa"], "istanbul_sides": ["anadolu", "avrupa"], "genres": ["Aile", "Aksiyon", "Animasyon", "Bilim Kurgu", "Dram", "Fantastik", "Gerilim", "Gizem", "IMAX", "Komedi", "Korku", "Macera", "Romantik"], "formats": ["2D", "3D"], "languages": ["3D / Türkçe Altyazılı", "3D / Türkçe Dublaj", "ALTY - AcikHava", "Altyazılı", "Dublaj", "Türkçe", "Türkçe Altyazılı", "Türkçe Dublaj"], "age_ratings": ["G", "Genel İzleyici Kitlesi", "6+", "6A", "10+", "10A", "PG", "13+", "13A", "PG-13", "16+", "R", "18+"], "date_range": {"min": "2026-08-01", "max": "2026-08-08"}, "theater_count": 110, "movie_count": 80, "session_count": 13689}}