diff --git a/js/README.md b/js/README.md
index cc56422..93f6f31 100644
--- a/js/README.md
+++ b/js/README.md
@@ -1,5 +1,7 @@
 # PMTiles for Browsers + NodeJS
 
+See the [JavaScript API docs](https://protomaps.github.io/PMTiles/typedoc/)
+
 the [PMTiles](https://www.npmjs.com/package/pmtiles) package can be included via script tag or ES6 module:
 
 ```html