Search: Find pictures added, updated and/or edited at or after a certain time

[lastzero]

As a mobile application developer, I want to use the Search API endpoint to find pictures that were added, updated and/or edited at or after a certain time (specified according to RFC3339) so that I can synchronize/compare my data with the server.

The following new search filters have been implemented for this:

Filter	Type	Example	Notes
added	timestamp	added:"2006-01-02T15:04:05Z"	Finds pictures added at or after this time
edited	timestamp	edited:"2006-01-02T15:04:05Z"	Finds pictures edited at or after this time
updated	timestamp	updated:"2006-01-02T15:04:05Z"	Finds pictures updated at or after this time

In addition, clients can ask to sort the search results by photos.updated_at timestamp if they specify updated as order. Results where created_at >= updated_at are not returned in this case.

Our Developer Guide provides an overview of the native apps currently available (you are welcome to submit a pull request for these docs if you develop an app that is not listed yet):

• https://docs.photoprism.app/developer-guide/native-apps/

[lastzero]

Our public demo and development preview have been updated so you can test these changes:

• https://docs.photoprism.app/getting-started/updates/#development-preview

[lastzero]

We've additionally expanded our Developer Guide with information on how to use the Search API endpoint, so that it is easy to find and can be used as a reference going forward (more search endpoints may be added to these docs as needed):

• https://docs.photoprism.app/developer-guide/api/search/
• https://docs.photoprism.app/developer-guide/api/thumbnails/#image-endpoint-uri

[lastzero]

Based on feedback from our developer community, the API now expects the times to be specified according to RFC3339 (e.g. 2006-01-02T15:04:05Z) when using the search filters directly as GET request parameters:

• https://docs.photoprism.app/developer-guide/api/search/#search-filters