API: `GET /api/v1/photos` should also return face information #2211

New issue

Open

opened 2026-02-20 01:08:03 -05:00 by deekerman · 2 comments

deekerman commented

2026-02-20 01:08:03 -05:00

Owner

Originally created by @DrDonoso on GitHub (Nov 6, 2024).

Describe what problem this solves and why this would be valuable to many users

I'm using the api to return a random photo at api/v1/photos. I would like to see the faces appearing in the photo.
When seeing the API, the faces are not returned in the response.
I can see the call at api/v1/photos/{uid} return faces, but it returns a number instead of the faces object.

It would be nice to return an array with the faces detected.

Thanks for your great effort! 😊

Describe the solution you'd like

Improve /api/v1/photos and /api/v1/photos/{uid} to return the faces object.

Describe alternatives you've considered

Additional context

Originally created by @DrDonoso on GitHub (Nov 6, 2024). **Describe what problem this solves and why this would be valuable to many users** I'm using the api to return a random photo at _api/v1/photos_. I would like to see the faces appearing in the photo. When seeing the [API](https://docs.photoprism.dev/#/Photos/SearchPhotos), the faces are not returned in the response. I can see the call at _api/v1/photos/{uid}_ return faces, but it returns a number instead of the faces object. It would be nice to return an array with the faces detected. Thanks for your great effort! 😊 **Describe the solution you'd like** Improve /api/v1/photos and /api/v1/photos/{uid} to return the faces object. **Describe alternatives you've considered** - **Additional context** -

deekerman added the

idea

api

faces

labels

2026-02-20 01:08:03 -05:00

deekerman commented

2026-02-20 01:08:03 -05:00

Author

Owner

@lastzero commented on GitHub (Nov 6, 2024):

We probably won't be able to do this for performance reasons, as it would most likely require at least one additional query for each result - unless you just want the comma-separated names?

@lastzero commented on GitHub (Nov 6, 2024): We probably won't be able to do this for performance reasons, as it would most likely require at least one additional query for each result - unless you just want the comma-separated names?

deekerman commented

2026-02-20 01:08:04 -05:00

Author

Owner

@DrDonoso commented on GitHub (Nov 6, 2024):

I understand; comma-separated names would be nice if it's possible and don't have any impact in performance.

@DrDonoso commented on GitHub (Nov 6, 2024): I understand; comma-separated names would be nice if it's possible and don't have any impact in performance.