{"name":"Movie & Series Recommendations API","version":"2.3.0","description":"AI-powered movie and TV show recommendations using ChatGPT","documentation":"https://github.com/yourusername/movie-recommendations-api","features":{"smartFilters":"Combine genres, moods, and contexts for precise recommendations","realReviewLinks":"Only verified IMDb, Rotten Tomatoes, Metacritic URLs (no hallucinations)","aiPowered":"GPT-4 or GPT-3.5-turbo for intelligent content generation","flexibleModels":"Switch between models for cost/quality optimization","tokenOptimized":"Focus on cast, director, and review accuracy (no streaming sources)"},"endpoints":{"health":"GET /health - API health check","modelInfo":"GET /api/model-info - Current AI model information","recommend":{"method":"POST /api/recommend","description":"Get AI-powered recommendations","parameters":{"query":"string (required) - What you want to watch","type":"movie | tv | both (optional)","limit":"number 1-20 (optional)","filters":"string[] (optional) - Genres, moods, contexts"},"example":{"query":"scary movies for Halloween","filters":["Horror","Scary night","Thriller"],"limit":5}},"search":{"method":"GET /api/search","description":"Search for movies and TV shows","parameters":{"q":"string (required) - Search query","type":"movie | tv | both (optional)","limit":"number 1-20 (optional)","filters":"string (optional) - Comma-separated filters"},"example":"/api/search?q=thriller&filters=Crime,Mystery&limit=10"},"trending":{"method":"GET /api/trending/:mediaType","description":"Get trending content","parameters":{"mediaType":"movie | tv | all (path param)","timeWindow":"day | week (optional)","limit":"number 1-20 (optional)"},"example":"/api/trending/movie?timeWindow=week&limit=10"},"today":{"method":"GET /api/today","description":"Get today's curated recommendations (cached, updated daily)","features":["Pre-generated via cron at 6 AM UTC","Theme changes based on day/date (Friday Fun, Halloween, Christmas, etc.)","Returns 8 movies + 8 TV shows","Instant response (cached in D1 database)","Cost-effective: one API call per day"],"example":"/api/today"},"details":{"method":"GET /api/details","description":"Get detailed information about a title","parameters":{"title":"string (required)","year":"number (optional)","type":"movie | tv (optional)"},"example":"/api/details?title=Inception&year=2010"},"openapi":"GET /openapi.yaml - Full API specification"},"filterExamples":{"genres":["Comedy","Drama","Horror","Action","Thriller","Romance","Sci-Fi","Documentary","Crime"],"moods":["Scary night","Romantic evening","Feel good","Mind bending","Chill weekend","Rainy day"],"contexts":["Party with friends","Date night","Family time","Vacation vibes","Binge worthy"]},"notes":["Uses ChatGPT to generate all content (no TMDB/IMDb API)","Review links are real, verified URLs only (no hallucinations)","Streaming sources removed to optimize GPT context for better cast/director info","Filters improve recommendation accuracy significantly","Model can be changed via OPENAI_MODEL environment variable","Today's recommendations cached in D1 database for instant access"]}