diff --git a/api-reference/fans/get.mdx b/api-reference/fans/get.mdx
index a4803e11..6e0d9fa1 100644
--- a/api-reference/fans/get.mdx
+++ b/api-reference/fans/get.mdx
@@ -1,4 +1,4 @@
 ---
 title: Get Artist Fans
-openapi: "/api-reference/openapi/releases.json GET /api/fans"
+openapi: "/api-reference/openapi/releases.json GET /api/artists/{id}/fans"
 ---
diff --git a/api-reference/openapi/releases.json b/api-reference/openapi/releases.json
index 4a21d38e..574e45f8 100644
--- a/api-reference/openapi/releases.json
+++ b/api-reference/openapi/releases.json
@@ -682,18 +682,13 @@
         }
       }
     },
-    "/api/fans": {
+    "/api/artists/{id}/fans": {
       "get": {
-        "servers": [
-          {
-            "url": "https://api.recoupable.com"
-          }
-        ],
         "description": "Retrieve all social profiles from fans of an artist across all platforms. This endpoint aggregates fan data from all connected social media platforms. Supports pagination for large fan lists.",
         "parameters": [
           {
-            "name": "artist_account_id",
-            "in": "query",
+            "name": "id",
+            "in": "path",
             "description": "The unique identifier of the artist account to fetch fans for",
             "required": true,
             "schema": {
@@ -743,6 +738,26 @@
                 }
               }
             }
+          },
+          "401": {
+            "description": "Unauthorized - missing or invalid credentials",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ArtistFansErrorResponse"
+                }
+              }
+            }
+          },
+          "500": {
+            "description": "Internal server error",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ArtistFansErrorResponse"
+                }
+              }
+            }
           }
         }
       }
@@ -1436,11 +1451,11 @@
             "type": "string",
             "description": "Fan's biography or profile description"
           },
-          "followerCount": {
+          "follower_count": {
             "type": "integer",
             "description": "Number of followers the fan has"
           },
-          "followingCount": {
+          "following_count": {
             "type": "integer",
             "description": "Number of accounts the fan is following"
           },
diff --git a/docs.json b/docs.json
index 997442ca..20364d6c 100644
--- a/docs.json
+++ b/docs.json
@@ -48,6 +48,12 @@
               "api-reference/artist/profile"
             ]
           },
+          {
+            "group": "Fans",
+            "pages": [
+              "api-reference/fans/get"
+            ]
+          },
           {
             "group": "Tasks",
             "pages": [
@@ -164,12 +170,6 @@
               "api-reference/songs/catalog-songs-add",
               "api-reference/songs/catalog-songs-delete"
             ]
-          },
-          {
-            "group": "Fans",
-            "pages": [
-              "api-reference/fans/get"
-            ]
           }
         ]
       },