Feature Request: Ability to query by upload_date

[danjoe4]

I have a pretty simple use case. I want to run a daily cron to retrieve all subtitles uploaded that day. I could run a cron every second to constantly retrieve api/discover/latest but there are some edge cases. Any downtime or failures would result in me missing a bunch of uploads, or if someone uploads more than 60 subtitles at once. It would be far more reliable if I could retrieve things by date.

Let me know if this is something the dev team would consider adding.

[os_admin]

Hi,

Sorry it took so long to reply! Your use case is actually very common, and we’ve built a solution specifically for this problem.

Instead of polling the API constantly (which has the reliability issues you mentioned), we provide automated subtitle export files that are perfect for daily
synchronization:

Daily Current Month Export:

• Updated daily with all subtitles uploaded in the current month
• Eliminates the risk of missing uploads due to downtime or API limits
• More reliable than constant polling
• Available at: https://www.opensubtitles.com/dumps/subtitles/subtitle_ids_YYYY.MM.json.gz

How it works for your use case:

1. Download today’s current month export
2. Compare with yesterday’s version using the upload_date field
3. Extract only the subtitles uploaded on the specific day you need
4. No API rate limits, no missed uploads, no edge cases

Weekly Complete Export is also available if you need historical data or want to do a full sync.

You can find the complete documentation here: OpenSubtitles Subtitle Export Documentation | Opensubtitles REST API Docs

This approach is much more reliable than polling /discover/latest and handles all the edge cases you mentioned. The files are gzipped JSON with one subtitle object per
line, making them easy to process programmatically.

Let me know if you need any clarification on the file format or integration!