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

Author: slint

source/includes/oai-pmh/_root.md

@@ -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

source/includes/rate-limit/_root.md

@@ -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:

source/includes/resources/deposit/_list.md

@@ -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

source/includes/resources/records/_list.md

@@ -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`...)                                             |
@@ -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>