diff --git a/swh/web/client/client.py b/swh/web/client/client.py
--- a/swh/web/client/client.py
+++ b/swh/web/client/client.py
@@ -133,9 +133,7 @@
 
 
 class WebAPIClient:
-    """Client for the Software Heritage archive Web API, see
-
-    https://archive.softwareheritage.org/api/
+    """Client for the Software Heritage archive Web API, see :swh_web:`api/`
 
     """
 
@@ -146,7 +144,7 @@
     ):
         """Create a client for the Software Heritage Web API
 
-        See: https://archive.softwareheritage.org/api/
+        See: :swh_web:`api/`
 
         Args:
             api_url: base URL for API calls