Skip to content

docs: repoint /api/fans to /api/artists/{id}/fans #143

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sweetmantech merged 9 commits into from
Apr 21, 2026
Merged

docs: repoint /api/fans to /api/artists/{id}/fans #143

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
9 commits
Select commit Hold shift + click to select a range
4f27912
docs: repoint /api/fans to /api/artists/{id}/fans
arpitgupta1214 Apr 17, 2026
486e1f4
docs(fans): add security, 401, 500 to OpenAPI spec
arpitgupta1214 Apr 19, 2026
68324be
docs(fans): repoint mdx frontmatter; drop unused ArtistFansErrorRespo…
arpitgupta1214 Apr 19, 2026
2e04a2b
Merge remote-tracking branch 'origin/main' into chore/docs-artist-fan…
arpitgupta1214 Apr 20, 2026
052c0c9
docs: drop dead /api/segment/fans path from releases spec
arpitgupta1214 Apr 20, 2026
fc378d3
docs(fans): document 401 and 500 response codes
arpitgupta1214 Apr 20, 2026
0dedbc5
docs(fans): drop api.recoupable.com override, inherit recoup-api.verc…
arpitgupta1214 Apr 20, 2026
dedaf38
docs(fans): rename followerCount/followingCount to snake_case to matc…
arpitgupta1214 Apr 20, 2026
7568409
docs(nav): move Fans group from Releases tab to Artists tab
sweetmantech Apr 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion api-reference/fans/get.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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"
---
35 changes: 25 additions & 10 deletions api-reference/openapi/releases.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -682,18 +682,13 @@
}
}
},
"/api/fans": {
"/api/artists/{id}/fans": {
Comment thread
coderabbitai[bot] marked this conversation as resolved.
"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": {
Expand Down Expand Up @@ -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"
}
}
}
}
}
}
Expand Down Expand Up @@ -1436,11 +1451,11 @@
"type": "string",
"description": "Fan's biography or profile description"
},
"followerCount": {
"follower_count": {
Copy link
Copy Markdown

@cubic-dev-ai cubic-dev-ai Bot Apr 20, 2026 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: This renames response fields in ArtistFan, introducing an additional breaking contract change beyond the path migration.

Prompt for AI agents 
Check if this issue is valid — if so, understand the root cause and fix it. At api-reference/openapi/releases.json, line 1454:

<comment>This renames response fields in `ArtistFan`, introducing an additional breaking contract change beyond the path migration.</comment>

<file context>
@@ -1451,11 +1451,11 @@
             "description": "Fan's biography or profile description"
           },
-          "followerCount": {
+          "follower_count": {
             "type": "integer",
             "description": "Number of followers the fan has"
</file context>
Fix with Cubic

"type": "integer",
"description": "Number of followers the fan has"
},
"followingCount": {
"following_count": {
"type": "integer",
"description": "Number of accounts the fan is following"
},
Expand Down
12 changes: 6 additions & 6 deletions docs.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,12 @@
"api-reference/artist/profile"
]
},
{
"group": "Fans",
"pages": [
"api-reference/fans/get"
]
},
{
"group": "Tasks",
"pages": [
Expand Down Expand Up @@ -164,12 +170,6 @@
"api-reference/songs/catalog-songs-add",
"api-reference/songs/catalog-songs-delete"
]
},
{
"group": "Fans",
"pages": [
"api-reference/fans/get"
]
}
]
},
Expand Down