music nerd

AdminArtist data

Admin

Artist data

Artist data coverage: how many artists exist and have a Spotify ID, platform-ID coverage with today's count, link coverage per platform, the distribution of how many tracked fields each artist has, and enrichment readiness.

GET/api/admin/artist-data
GET/api/admin/artist-data

Artist data coverage: how many artists exist and have a Spotify ID, platform-ID coverage with today's count, link coverage per platform, the distribution of how many tracked fields each artist has, and enrichment readiness.

Authorization

Authorizationstringrequired

A Music Nerd admin's access token. Copy it at https://musicnerd.net/access after signing in. A signed-in user who is not an admin gets 403. Kept in this tab only.

cURL
curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/admin/artist-data'

Send the request to see the live response here.

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>. A Music Nerd admin's access token. Copy it at https://musicnerd.net/access after signing in. A signed-in user who is not an admin gets 403.

Response

application/json

The catalog summary; a repeat call within 30 seconds may return the same numbers.

statusstring · enumrequired

Values: "ok"

totalArtistsintegerrequired
totalWithSpotifyintegerrequired

Artists with a non-empty spotify.

platformIdCoveragearray<object>required

From artist_id_mappings, most mapped first. Only platforms with at least one mapping appear.

Item properties for platformIdCoverage
platformstringrequired
countintegerrequired
percentagenumberrequired

Of totalWithSpotify, to two decimals.

todayCountintegerrequired
artistLinkCoveragearray<object>required

One row per tracked column, in a fixed order: instagram, bluesky, x, facebook, tiktok, youtube, youtubechannel, soundcloud, bandcamp, subvert, discogs, lastfm, musicbrainz, wikidata, imdb, wikipedia, bio, linkedin, farcaster, twitch, patreon. Spotify is left out because it is the denominator elsewhere.

Item properties for artistLinkCoverage
columnstringrequired
categorystring · enumrequired

Values: "social", "listen", "reference", "content"

countintegerrequired
percentagenumberrequired

Of totalArtists, to two decimals.

completenessDistributionarray<object>required

How many of the tracked columns each artist has filled, bucketed 0-1, 2-3, 4-6, 7-10, 11+; empty buckets are absent.

Item properties for completenessDistribution
bucketstringrequired
countintegerrequired
percentagenumberrequired
medianFieldsnumberrequired
averageFieldsnumberrequired
enrichmentReadinessobjectrequired
Properties for enrichmentReadiness
hasWikidataintegerrequired
hasSpotifyNoWikidataintegerrequired
noSpotifyintegerrequired