From b656c58b39d501a17fbd2ae867b904204502a354 Mon Sep 17 00:00:00 2001
From: Peter Radko <cmtvpetya@gmail.com>
Date: Wed, 19 Mar 2025 02:23:40 +0300
Subject: [PATCH] docs: mention possibility of prerendering api routes (#31234)

---
 docs/1.getting-started/9.prerendering.md |  1 +
 docs/3.api/3.utils/prerender-routes.md   | 16 ++++++++++++++++
 2 files changed, 17 insertions(+)

diff --git a/docs/1.getting-started/9.prerendering.md b/docs/1.getting-started/9.prerendering.md
index 7f72b4bc9c..e646f73a53 100644
--- a/docs/1.getting-started/9.prerendering.md
+++ b/docs/1.getting-started/9.prerendering.md
@@ -144,6 +144,7 @@ You can use this at runtime within a [Nuxt context](/docs/guide/going-further/nu
 ```vue [pages/index.vue]
 <script setup>
 prerenderRoutes(["/some/other/url"]);
+prerenderRoutes("/api/content/article/my-article");
 </script>
 
 <template>
diff --git a/docs/3.api/3.utils/prerender-routes.md b/docs/3.api/3.utils/prerender-routes.md
index a806678bfd..459cf0403e 100644
--- a/docs/3.api/3.utils/prerender-routes.md
+++ b/docs/3.api/3.utils/prerender-routes.md
@@ -28,3 +28,19 @@ prerenderRoutes(['/', '/about'])
 ::note
 In the browser, or if called outside prerendering, `prerenderRoutes` will have no effect.
 ::
+
+You can even prerender API routes which is particularly useful for full statically generated sites (SSG) because you can then `$fetch` data as if you have an available server!
+
+```js
+prerenderRoutes('/api/content/article/name-of-article')
+
+// Somewhere later in App
+const articleContent = await $fetch('/api/content/article/name-of-article', {
+  responseType: 'json',
+})
+```
+
+::warning
+Prerendered API routes in production may not return the expected response headers, depending on the provider you deploy to. For example, a JSON response might be served with an `application/octet-stream` content type.
+Always manually set `responseType` when fetching prerendered API routes.
+::