Skip to content

global: update rate-limits and search/OAI-PMH page size #68

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
slint merged 1 commit into from
Apr 10, 2026
Merged

global: update rate-limits and search/OAI-PMH page size #68

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion source/includes/oai-pmh/_root.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ info.earliestDatestamp

## Resumption tokens

Resumption tokens are only valid for **2 minutes**. In case a token expired, you will receive a ``422 Unprocessable Entity`` HTTP error.
The OAI-PMH API returns **50 records per page**. Resumption tokens are only valid for **2 minutes**. In case a token expired, you will receive a ``422 Unprocessable Entity`` HTTP error.

<aside class="notice">
This means that you must execute the next HTTP request using the
Expand Down
3 changes: 2 additions & 1 deletion source/includes/rate-limit/_root.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@ To achieve this, we have rate-limiting measures in place which limit the number
|:------------------|:------------------------------------------------------------------------------|
| Global limit for guest users | 60 requests per minute, 2000 requests per hour |
| Global limit for [authenticated users](#authentication) | 100 requests per minute, 5000 requests per hour |
| OAI-PMH API harvesting | 120 requests per minute |
| Search REST API endpoints | 30 requests per minute |
| OAI-PMH API harvesting | 30 requests per minute |
| Thumbnails for image records | 20 requests per minute |

When you are making requests to any of our endpoints, you can inspect the following HTTP response headers for more information of your current rate-limit status:
Expand Down
2 changes: 1 addition & 1 deletion source/includes/resources/deposit/_list.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ curl -i -H "Authorization: Bearer ACCESS_TOKEN" /api/deposit/depositions/
| `status`</br>_string_ | optional | Filter result based on deposit status (either ``draft`` or ``published``) |
| `sort`</br>_string_ | optional | Sort order (``bestmatch`` or ``mostrecent``). Prefix with minus to change form ascending to descending (e.g. ``-mostrecent``). |
| `page`</br>_integer_ | optional | Page number for pagination. |
| `size`</br>_integer_ | optional | Number of results to return per page. |
| `size`</br>_integer_ | optional | Number of results to return per page. Maximum 100. |
| `all_versions`</br>_integer/string_ | optional | Show (`true` or `1`) or hide (`false` or `0`) all versions of deposits. |

#### Success Response
Expand Down
6 changes: 5 additions & 1 deletion source/includes/resources/records/_list.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ curl -i -H "Authorization: Bearer ACCESS_TOKEN" /api/records/
| `status`</br>_string_ | optional | Filter result based on the deposit status (either ``draft`` or ``published``) |
| `sort`</br>_string_ | optional | Sort order (``bestmatch`` or ``mostrecent``). Prefix with minus to change form ascending to descending (e.g. ``-mostrecent``). |
| `page`</br>_integer_ | optional | Page number for pagination. |
| `size`</br>_integer_ | optional | Number of results to return per page. |
| `size`</br>_integer_ | optional | Number of results to return per page. Maximum 25 for anonymous requests, 100 for authenticated requests. |
| `all_versions`</br>_integer/string_ | optional | Show (`true` or `1`) or hide (`false` or `0`) all versions of records. |
| `communities`</br> _string_ | optional | Return records that are part of the specified communities. (Use of `community identifier`) |
| `type`</br> _string_ | optional | Return records of the specified type. (`Publication`, `Poster`, `Presentation`...) |
Expand Down Expand Up @@ -61,3 +61,7 @@ See [HTTP status codes](#http-status-codes) (400 and 500 series errors) and
#### Search guide

Advanced search queries can as well be performed on Zenodo website through the search box. This is documented in the [search guide](https://help.zenodo.org/guides/search/)

<aside class="notice">
<strong>For bulk data access:</strong> If you need to download or process large numbers of records, we recommend using <a href="#oai-pmh">OAI-PMH harvesting</a> or <a href="#metadata-dumps">metadata dumps</a> instead of the search API. These methods are specifically designed for bulk access and will be more efficient for your use case.
</aside>