diff --git a/docs/faq/index.rst b/docs/faq/index.rst
--- a/docs/faq/index.rst
+++ b/docs/faq/index.rst
@@ -205,7 +205,7 @@
 Is there a page where I can see all the API endpoints?
 ------------------------------------------------------
 
-See the `API endpoint listing page <API>`_.
+See the `API endpoint listing page`_.
 
 What are the usage limits for SWH APIs?
 ---------------------------------------
@@ -215,7 +215,7 @@
 * 120 for anonymous users
 * 1200 for authenticated users
 
-It's described in the `rate limit documentation page <API-rate-limit>`_.
+It's described in the `rate limit documentation page`_.
 
 .. It's temporarily here but it should be moved into its own sphinx instance at some
    point in the future.
@@ -245,8 +245,8 @@
 volume, that may need human intervention.
 
 
-.. _API: https://archive.softwareheritage.org/api/1/
-.. _API-rate-limit: https://archive.softwareheritage.org/api/#rate-limiting
+.. _API endpoint listing page: https://archive.softwareheritage.org/api/1/
+.. _rate limit documentation page: https://archive.softwareheritage.org/api/#rate-limiting
 .. _bug tracking system: https://forge.softwareheritage.org/
 .. _contact form: https://www.softwareheritage.org/contact/
 .. _contact us: https://www.softwareheritage.org/contact/