diff --git a/swh/web/templates/api/api.html b/swh/web/templates/api/api.html
--- a/swh/web/templates/api/api.html
+++ b/swh/web/templates/api/api.html
@@ -247,7 +247,8 @@
Due to limited resource availability on the back end side, API usage is currently rate limited.
API users can be either anonymous or authenticated. For rate-limiting purposes, anonymous users
are identified by their origin IP address; authenticated users identify themselves via user-specific
- credentials, like authentication tokens.
+ credentials, like authentication tokens.
+ A higher rate-limit quota is available by default for authenticated users.
@@ -257,6 +258,7 @@
X-RateLimit-Limit
: maximum number of permitted requests per hour
+ (120 for anonymous users, 1200 for authenticated users)
X-RateLimit-Remaining
: number of permitted requests remaining before the next
@@ -271,9 +273,9 @@
Example:
curl -i https://archive.softwareheritage.org/api/1/stat/counters/ | grep ^X-RateLimit
-X-RateLimit-Limit: 60
-X-RateLimit-Remaining: 54
-X-RateLimit-Reset: 1485794532
+X-RateLimit-Limit: 120
+X-RateLimit-Remaining: 119
+X-RateLimit-Reset: 1620639052