From 31d909ed1a2c43f6c7e898ffcd67d62dcf4149b7 Mon Sep 17 00:00:00 2001 From: Traun Leyden Date: Thu, 20 Nov 2025 09:14:21 +0100 Subject: [PATCH 1/7] Update API documentation for daily papers Add params documentation for /api/daily_papers --- docs/hub/api.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/docs/hub/api.md b/docs/hub/api.md index 0d4b29ed82..5e22bb2e0e 100644 --- a/docs/hub/api.md +++ b/docs/hub/api.md @@ -462,6 +462,22 @@ Get the daily papers curated by AK and the community. It's the equivalent of [ht To filter on a particular date, simply pass the date like so: https://huggingface.co/api/daily_papers?date=2025-03-31. +Other keywords that are supported: + +1. `limit` - the number of pages returned +2. `p` - the page number, for paging through results +3. `submitter` - to filter by summitter +4. `date`, `week`, `month` - for filtering by date range +5. `sort` - to specify how results are sorted. + +See the [OpenAPI Playground for Daily Papers](https://huggingface-openapi.hf.space/#tag/papers) for the full list of params. + +### GET /api/papers/search + +Search the daily papers by keyword: + +1. `q` - the keyword to search + ## Collections API Use Collections to group repositories from the Hub (Models, Datasets, Spaces and Papers) on a dedicated page. From a6a0781bcb37d4d29b2d15544ed63ff00a89c897 Mon Sep 17 00:00:00 2001 From: Traun Leyden Date: Thu, 20 Nov 2025 16:40:18 +0100 Subject: [PATCH 2/7] Update docs/hub/api.md Co-authored-by: Merve Noyan --- docs/hub/api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hub/api.md b/docs/hub/api.md index 5e22bb2e0e..18af0c0ef7 100644 --- a/docs/hub/api.md +++ b/docs/hub/api.md @@ -466,7 +466,7 @@ Other keywords that are supported: 1. `limit` - the number of pages returned 2. `p` - the page number, for paging through results -3. `submitter` - to filter by summitter +3. `submitter` - to filter the paper submitter 4. `date`, `week`, `month` - for filtering by date range 5. `sort` - to specify how results are sorted. From f7af62b06a5d210af4b50c005866b5fa2e80a004 Mon Sep 17 00:00:00 2001 From: Traun Leyden Date: Thu, 20 Nov 2025 16:44:34 +0100 Subject: [PATCH 3/7] Update API documentation for limit keyword --- docs/hub/api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hub/api.md b/docs/hub/api.md index 18af0c0ef7..8fb456d3b1 100644 --- a/docs/hub/api.md +++ b/docs/hub/api.md @@ -464,7 +464,7 @@ To filter on a particular date, simply pass the date like so: https://huggingfac Other keywords that are supported: -1. `limit` - the number of pages returned +1. `limit` - the number of papers returned 2. `p` - the page number, for paging through results 3. `submitter` - to filter the paper submitter 4. `date`, `week`, `month` - for filtering by date range From 89c27bfe5052b6402349d555746ab6013f9c2d33 Mon Sep 17 00:00:00 2001 From: Traun Leyden Date: Thu, 20 Nov 2025 16:46:19 +0100 Subject: [PATCH 4/7] Update API documentation for sorting parameter Clarify the default sorting behavior and options for the API. --- docs/hub/api.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/hub/api.md b/docs/hub/api.md index 8fb456d3b1..12dd9c6fa8 100644 --- a/docs/hub/api.md +++ b/docs/hub/api.md @@ -468,7 +468,7 @@ Other keywords that are supported: 2. `p` - the page number, for paging through results 3. `submitter` - to filter the paper submitter 4. `date`, `week`, `month` - for filtering by date range -5. `sort` - to specify how results are sorted. +5. `sort` - to specify how results are sorted. Defaults to "publishedAt", but can be set to "trending" as well. See the [OpenAPI Playground for Daily Papers](https://huggingface-openapi.hf.space/#tag/papers) for the full list of params. @@ -476,7 +476,7 @@ See the [OpenAPI Playground for Daily Papers](https://huggingface-openapi.hf.spa Search the daily papers by keyword: -1. `q` - the keyword to search +* `q` - the keyword to search ## Collections API From f80ce41ad7be4fe671bee60238f13664bf128f89 Mon Sep 17 00:00:00 2001 From: Traun Leyden Date: Thu, 20 Nov 2025 16:50:14 +0100 Subject: [PATCH 5/7] Update API documentation for date filtering parameters Clarified filtering parameters for date and sorting in API documentation. --- docs/hub/api.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/hub/api.md b/docs/hub/api.md index 12dd9c6fa8..4be72f0487 100644 --- a/docs/hub/api.md +++ b/docs/hub/api.md @@ -467,8 +467,8 @@ Other keywords that are supported: 1. `limit` - the number of papers returned 2. `p` - the page number, for paging through results 3. `submitter` - to filter the paper submitter -4. `date`, `week`, `month` - for filtering by date range -5. `sort` - to specify how results are sorted. Defaults to "publishedAt", but can be set to "trending" as well. +4. `date`, `week`, `month` - for filtering by date range on the date the paper was included in Daily Papers +5. `sort` - to specify how results are sorted. Defaults to "publishedAt", but can be set to "trending" as well See the [OpenAPI Playground for Daily Papers](https://huggingface-openapi.hf.space/#tag/papers) for the full list of params. From b3d8b14ee1f7fd7e527f72cedc08dc1433858d5e Mon Sep 17 00:00:00 2001 From: Traun Leyden Date: Fri, 21 Nov 2025 14:05:55 +0100 Subject: [PATCH 6/7] Update docs/hub/api.md Co-authored-by: Merve Noyan --- docs/hub/api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/hub/api.md b/docs/hub/api.md index 4be72f0487..426c28cd2b 100644 --- a/docs/hub/api.md +++ b/docs/hub/api.md @@ -474,7 +474,7 @@ See the [OpenAPI Playground for Daily Papers](https://huggingface-openapi.hf.spa ### GET /api/papers/search -Search the daily papers by keyword: +Search the daily papers by keyword `q` (the keyword to search) * `q` - the keyword to search From 15fcf2c78c1ac5ed94cc49f7431e5db33aedb83d Mon Sep 17 00:00:00 2001 From: Traun Leyden Date: Fri, 21 Nov 2025 14:06:03 +0100 Subject: [PATCH 7/7] Update docs/hub/api.md Co-authored-by: Merve Noyan --- docs/hub/api.md | 1 - 1 file changed, 1 deletion(-) diff --git a/docs/hub/api.md b/docs/hub/api.md index 426c28cd2b..87035fae85 100644 --- a/docs/hub/api.md +++ b/docs/hub/api.md @@ -476,7 +476,6 @@ See the [OpenAPI Playground for Daily Papers](https://huggingface-openapi.hf.spa Search the daily papers by keyword `q` (the keyword to search) -* `q` - the keyword to search ## Collections API