diff --git a/doc/api/punycode.md b/doc/api/punycode.md
index 620585afa484c1..c9c20ce6350c7e 100644
--- a/doc/api/punycode.md
+++ b/doc/api/punycode.md
@@ -12,7 +12,9 @@ deprecated: v7.0.0
 **The version of the punycode module bundled in Node.js is being deprecated**.
 In a future major version of Node.js this module will be removed. Users
 currently depending on the `punycode` module should switch to using the
-userland-provided [Punycode.js][] module instead.
+userland-provided [Punycode.js][] module instead. For punycode-based URL
+encoding, see [`url.domainToASCII`][] or, more generally, the
+[WHATWG URL API][].
 
 The `punycode` module is a bundled version of the [Punycode.js][] module. It
 can be accessed using:
@@ -150,3 +152,5 @@ Returns a string identifying the current [Punycode.js][] version number.
 
 [Punycode]: https://tools.ietf.org/html/rfc3492
 [Punycode.js]: https://github.com/bestiejs/punycode.js
+[WHATWG URL API]: url.md#url_the_whatwg_url_api
+[`url.domainToASCII`]: url.md#url_url_domaintoascii_domain