music nerd

Artist lookupsRead the contributor leaderboard

Artist lookups

Read the contributor leaderboard

Returns contributors ranked by artists added plus research submissions, all-time or between from and to. email and wallet are always null. Send page or perPage for a paginated list.

GET/api/leaderboard
GET/api/leaderboard

Returns contributors ranked by artists added plus research submissions, all-time or between from and to. email and wallet are always null. Send page or perPage for a paginated list.

Query

fromstring

Start of the period (inclusive). Counts only when to is also sent.

tostring

End of the period (inclusive).

pageinteger

Page number. Sending it paginates the response.

perPageinteger

Entries per page. Sending it paginates the response.

cURL
curl --request GET \
  --url 'https://musicnerd-api.vercel.app/api/leaderboard?page=1&perPage=10'

Send the request to see the live response here.

Authorizations

None. This endpoint is public.

Query Parameters

fromstring

Start of the period (inclusive). Counts only when to is also sent.

tostring

End of the period (inclusive).

pageinteger

Page number. Sending it paginates the response.

Default: 1

perPageinteger

Entries per page. Sending it paginates the response.

Default: 10

Response

application/json

The ranked entries: an array, or { entries, total, pageCount } when paginated. Counts are strings in the all-time list and integers in a period.

oneOf · array<LeaderboardEntry> 1
userIdstringrequired

format: uuid

walletnullrequired
usernamestringrequired

The chosen name, or Anonymous.

emailnullrequired
isHiddenbooleanrequired
artistsCountstring | integerrequired

Artists the account added: a numeric string all-time, an integer in a period.

ugcCountstring | integerrequired

Research submissions: a numeric string all-time, an integer in a period.

oneOf · object 2
entriesarray<LeaderboardEntry>required
Item properties for entries
userIdstringrequired

format: uuid

walletnullrequired
usernamestringrequired

The chosen name, or Anonymous.

emailnullrequired
isHiddenbooleanrequired
artistsCountstring | integerrequired

Artists the account added: a numeric string all-time, an integer in a period.

ugcCountstring | integerrequired

Research submissions: a numeric string all-time, an integer in a period.

totalintegerrequired
pageCountintegerrequired