diff --git a/docs/hub/api.md b/docs/hub/api.md
index 36877e894..fb74cb49f 100644
--- a/docs/hub/api.md
+++ b/docs/hub/api.md
@@ -429,6 +429,9 @@ Get all the models, datasets, and Spaces that refer to a paper.
 
 Get the daily papers curated by AK and the community. It's the equivalent of [https://huggingface.co/papers](https://huggingface.co/papers).
 
+To filter on a particular date, simply pass the date like so: https://huggingface.co/api/daily_papers?date=2025-03-31.
+You can also pass a month, like https://huggingface.co/api/daily_papers?month=2025-04 or week, like https://huggingface.co/api/daily_papers/week/2025-W16.
+
 ## Collections API
 
 Use Collections to group repositories from the Hub (Models, Datasets, Spaces and Papers) on a dedicated page.