Skip to main content

Movies API Reference

Endpoints for browsing shared movie catalog records and managing personal movie tracking lists.

1. List Public Movie Catalog

GET /api/v1/movies Retrieves public movie catalog entries with query search, pagination, and sorting.

Query Parameters

Example Response (200 OK)


2. Create Movie in Public Catalog

POST /api/v1/movies Adds a new movie to the shared global catalog. Requires authentication.

Request Body


3. Get User Personal Movie List

GET /api/v1/movies/list Retrieves movies saved on the authenticated user’s personal list.

Query Parameters

  • status: Filter by status (watching, completed, on_hold, dropped, plan_to_watch).

Response (200 OK)


4. Add Movie to Personal List

POST /api/v1/movies/list Adds a movie to the user’s tracking list.

Request Body


5. Bulk Operations

Bulk Update Status

POST /api/v1/movies/bulk-status

Bulk Delete

POST /api/v1/movies/bulk-delete