AudiusProject · dylanjeffers · Mar 17, 2026
diff --git a/api/dbv1/db.go b/api/dbv1/db.go
diff --git a/api/dbv1/exists.sql.go b/api/dbv1/exists.sql.go
diff --git a/api/dbv1/get_account_playlists.sql.go b/api/dbv1/get_account_playlists.sql.go
diff --git a/api/dbv1/get_connected_wallets.sql.go b/api/dbv1/get_connected_wallets.sql.go
diff --git a/api/dbv1/get_developer_apps.sql.go b/api/dbv1/get_developer_apps.sql.go
diff --git a/api/dbv1/get_events.sql.go b/api/dbv1/get_events.sql.go
diff --git a/api/dbv1/get_extended_account_fields.sql.go b/api/dbv1/get_extended_account_fields.sql.go
diff --git a/api/dbv1/get_genres.sql.go b/api/dbv1/get_genres.sql.go
diff --git a/api/dbv1/get_grants.sql.go b/api/dbv1/get_grants.sql.go
diff --git a/api/dbv1/get_playlist_ids_by_permalink.sql.go b/api/dbv1/get_playlist_ids_by_permalink.sql.go
diff --git a/api/dbv1/get_playlist_ids_by_upc.sql.go b/api/dbv1/get_playlist_ids_by_upc.sql.go
diff --git a/api/dbv1/get_playlists.sql.go b/api/dbv1/get_playlists.sql.go
diff --git a/api/dbv1/get_plays.sql.go b/api/dbv1/get_plays.sql.go
diff --git a/api/dbv1/get_track_ids_by_isrc.sql.go b/api/dbv1/get_track_ids_by_isrc.sql.go
diff --git a/api/dbv1/get_track_ids_by_permalink.sql.go b/api/dbv1/get_track_ids_by_permalink.sql.go
diff --git a/api/dbv1/get_tracks.sql.go b/api/dbv1/get_tracks.sql.go
diff --git a/api/dbv1/get_undisbursed_challenges.sql.go b/api/dbv1/get_undisbursed_challenges.sql.go
diff --git a/api/dbv1/get_user_for_handle.sql.go b/api/dbv1/get_user_for_handle.sql.go
diff --git a/api/dbv1/get_user_for_wallet.sql.go b/api/dbv1/get_user_for_wallet.sql.go
diff --git a/api/dbv1/get_users.sql.go b/api/dbv1/get_users.sql.go
diff --git a/api/dbv1/models.go b/api/dbv1/models.go
diff --git a/api/dbv1/queries/get_tracks.sql b/api/dbv1/queries/get_tracks.sql
@@ -33,6 +33,14 @@ SELECT
   duration,
   is_downloadable,
   COALESCE(aggregate_plays.count, 0) as play_count,
+  (
+    SELECT count(*)::bigint
+    FROM track_downloads d
+    WHERE (t.stem_of IS NOT NULL
+           AND d.parent_track_id = (t.stem_of->>'parent_track_id')::int
+           AND d.track_id = t.track_id)
+       OR (t.stem_of IS NULL AND d.parent_track_id = t.track_id)
+  ) AS download_count,
   ddex_app,
   pinned_comment_id,
   playlists_containing_track,

diff --git a/api/swagger/swagger-v1.yaml b/api/swagger/swagger-v1.yaml
@@ -13992,6 +13992,7 @@ components:
         - is_unlisted
         - permalink
         - play_count
+        - download_count
         - preview
         - remix_of
         - repost_count
@@ -14047,6 +14048,9 @@ components:
           type: boolean
         play_count:
           type: integer
+        download_count:
+          type: integer
+          description: Full track + all stems (parent) or stem-only (stem)
         permalink:
           type: string
         is_streamable:
@@ -15458,6 +15462,7 @@ components:
         - is_unlisted
         - permalink
         - play_count
+        - download_count
         - preview
         - remix_of
         - repost_count
@@ -15513,6 +15518,9 @@ components:
           type: boolean
         play_count:
           type: integer
+        download_count:
+          type: integer
+          description: Full track + all stems (parent) or stem-only (stem)
         permalink:
           type: string
         is_streamable:

diff --git a/api/v1_track_test.go b/api/v1_track_test.go
@@ -1,11 +1,13 @@
 package api
 
 import (
+	"context"
 	"testing"
 
 	"api.audius.co/api/dbv1"
 	"api.audius.co/trashid"
 	"github.com/stretchr/testify/assert"
+	"github.com/stretchr/testify/require"
 )
 
 func TestGetTrack(t *testing.T) {
@@ -18,9 +20,33 @@ func TestGetTrack(t *testing.T) {
 	assert.Equal(t, 200, status)
 
 	jsonAssert(t, body, map[string]any{
-		"data.id":         "eYJyn",
-		"data.title":      "Culca Canyon",
-		"data.play_count": 0,
+		"data.id":             "eYJyn",
+		"data.title":          "Culca Canyon",
+		"data.play_count":     0,
+		"data.download_count": 0,
+	})
+}
+
+func TestGetTrackDownloadCount(t *testing.T) {
+	app := testAppWithFixtures(t)
+	ctx := context.Background()
+	require.NotNil(t, app.writePool, "test requires write pool")
+
+	// Track 200 is "Culca Canyon" (eYJyn). Insert two download rows so download_count is 2.
+	_, err := app.writePool.Exec(ctx, `
+		INSERT INTO track_downloads (txhash, blocknumber, parent_track_id, track_id, user_id)
+		VALUES ('tx-dl-1', 101, 200, 200, 1), ('tx-dl-2', 101, 200, 200, 2)
+	`)
+	require.NoError(t, err)
+
+	var trackResponse struct {
+		Data dbv1.Track
+	}
+	status, body := testGet(t, app, "/v1/full/tracks/eYJyn", &trackResponse)
+	assert.Equal(t, 200, status)
+	jsonAssert(t, body, map[string]any{
+		"data.id":             "eYJyn",
+		"data.download_count": 2,
 	})
 }
 

diff --git a/api/v1_tracks_test.go b/api/v1_tracks_test.go
@@ -19,8 +19,9 @@ func TestTracksEndpoint(t *testing.T) {
 	assert.Equal(t, 200, status)
 
 	jsonAssert(t, body, map[string]any{
-		"data.0.id":    "eYZmn",
-		"data.0.title": "T1",
+		"data.0.id":             "eYZmn",
+		"data.0.title":         "T1",
+		"data.0.download_count": 0,
 	})
 }
 
@@ -31,8 +32,9 @@ func TestGetTracksByPermalink(t *testing.T) {
 	assert.Equal(t, 200, status)
 
 	jsonAssert(t, body, map[string]any{
-		"data.0.id":    "eYake",
-		"data.0.title": "track by permalink",
+		"data.0.id":             "eYake",
+		"data.0.title":         "track by permalink",
+		"data.0.download_count": 0,
 	})
 }