feat(frontend/api): movie recommendations/similar request and frontend detail page update

server/api/themoviedb.ts

@@ -286,6 +286,58 @@ class TheMovieDb {
     }
   };
 
+  public async getMovieRecommendations({
+    movieId,
+    page = 1,
+    language = 'en-US',
+  }: {
+    movieId: number;
+    page?: number;
+    language?: string;
+  }): Promise<TmdbSearchMovieResponse> {
+    try {
+      const response = await this.axios.get<TmdbSearchMovieResponse>(
+        `/movie/${movieId}/recommendations`,
+        {
+          params: {
+            page,
+            language,
+          },
+        }
+      );
+
+      return response.data;
+    } catch (e) {
+      throw new Error(`[TMDB] Failed to fetch discover movies: ${e.message}`);
+    }
+  }
+
+  public async getMovieSimilar({
+    movieId,
+    page = 1,
+    language = 'en-US',
+  }: {
+    movieId: number;
+    page?: number;
+    language?: string;
+  }): Promise<TmdbSearchMovieResponse> {
+    try {
+      const response = await this.axios.get<TmdbSearchMovieResponse>(
+        `/movie/${movieId}/similar`,
+        {
+          params: {
+            page,
+            language,
+          },
+        }
+      );
+
+      return response.data;
+    } catch (e) {
+      throw new Error(`[TMDB] Failed to fetch discover movies: ${e.message}`);
+    }
+  }
+
   public getDiscoverMovies = async ({
     sortBy = 'popularity.desc',
     page = 1,

server/overseerr-api.yml

@@ -1236,6 +1236,86 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/MovieDetails'
+  /movie/{movieId}/recommendations:
+    get:
+      summary: Request recommended movies
+      description: Returns list of recommended movies based on provided movie ID in JSON format
+      tags:
+        - movies
+      parameters:
+        - in: path
+          name: movieId
+          required: true
+          schema:
+            type: number
+            example: 337401
+        - in: query
+          name: page
+          schema:
+            type: number
+            example: 1
+            default: 1
+      responses:
+        '200':
+          description: List of movies
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  page:
+                    type: number
+                    example: 1
+                  totalPages:
+                    type: number
+                    example: 20
+                  totalResults:
+                    type: number
+                    example: 200
+                  results:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/MovieResult'
+  /movie/{movieId}/similar:
+    get:
+      summary: Request similar movies
+      description: Returns list of similar movies based on provided movie ID in JSON format
+      tags:
+        - movies
+      parameters:
+        - in: path
+          name: movieId
+          required: true
+          schema:
+            type: number
+            example: 337401
+        - in: query
+          name: page
+          schema:
+            type: number
+            example: 1
+            default: 1
+      responses:
+        '200':
+          description: List of movies
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  page:
+                    type: number
+                    example: 1
+                  totalPages:
+                    type: number
+                    example: 20
+                  totalResults:
+                    type: number
+                    example: 200
+                  results:
+                    type: array
+                    items:
+                      $ref: '#/components/schemas/MovieResult'
   /tv/{tvId}:
     get:
       summary: Request tv details

server/routes/movie.ts

@@ -2,6 +2,7 @@ import { Router } from 'express';
 import TheMovieDb from '../api/themoviedb';
 import { mapMovieDetails } from '../models/Movie';
 import { MediaRequest } from '../entity/MediaRequest';
+import { mapMovieResult } from '../models/Search';
 
 const movieRoutes = Router();
 
@@ -15,4 +16,54 @@ movieRoutes.get('/:id', async (req, res) => {
   return res.status(200).json(mapMovieDetails(movie, request));
 });
 
+movieRoutes.get('/:id/recommendations', async (req, res) => {
+  const tmdb = new TheMovieDb();
+
+  const results = await tmdb.getMovieRecommendations({
+    movieId: Number(req.params.id),
+    page: Number(req.query.page),
+  });
+
+  const requests = await MediaRequest.getRelatedRequests(
+    results.results.map((result) => result.id)
+  );
+
+  return res.status(200).json({
+    page: results.page,
+    totalPages: results.total_pages,
+    totalResults: results.total_results,
+    results: results.results.map((result) =>
+      mapMovieResult(
+        result,
+        requests.find((req) => req.mediaId === result.id)
+      )
+    ),
+  });
+});
+
+movieRoutes.get('/:id/similar', async (req, res) => {
+  const tmdb = new TheMovieDb();
+
+  const results = await tmdb.getMovieSimilar({
+    movieId: Number(req.params.id),
+    page: Number(req.query.page),
+  });
+
+  const requests = await MediaRequest.getRelatedRequests(
+    results.results.map((result) => result.id)
+  );
+
+  return res.status(200).json({
+    page: results.page,
+    totalPages: results.total_pages,
+    totalResults: results.total_results,
+    results: results.results.map((result) =>
+      mapMovieResult(
+        result,
+        requests.find((req) => req.mediaId === result.id)
+      )
+    ),
+  });
+});
+
 export default movieRoutes;