Skip to content

Add GET /api​/v1​/users​/me​/videos​/likes endpoint to retrieve a user's liked videos #7487

@ritteraf

Description

@ritteraf

Describe the problem to be solved

There is currently no way for an authenticated user to retrieve a list of videos they have liked. The rate system (PUT /api​/v1​/videos/{id}/rate) records likes against videos, but there is no corresponding read endpoint to surface that data back to the user as a collection. Third-party clients (and PeerTube's own web UI) have no way to implement a "Liked Videos" library feature because the data is write-only from the API's perspective.

Describe the solution you would like

Add a dedicated endpoint GET /api​/v1​/users​/me​/videos​/likes, following the exact same pattern as the existing watch history endpoint GET /api​/v1​/users​/me​/videos​/history. It should:

• Require authentication
• Return a standard paginated Video​List response (same Video object shape used across all video list endpoints)
• Support start and count pagination parameters
• Support a search query parameter to filter results by video title (same as GET /api​/v1​/users​/me​/videos​/history)
• Sort by liked​At descending by default (most recently liked first)
• Be automatically maintained by the server — populated when a user submits rating: "like" and depopulated when the rating is removed or changed. No manual client management.

This is a read-only mirror of a signal the server already records. The write path already exists. This request is purely for the missing read path.

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions