Skip to main content
GET
/
v1
/
collecting
/
stats
Collection stats
curl --request GET \
  --url https://api.rewind.rest/v1/collecting/stats \
  --header 'Authorization: Bearer <token>'
{
  "total_items": 284,
  "by_format": {
    "vinyl": 253,
    "cd": 29,
    "cassette": 0,
    "other": 2
  },
  "wantlist_count": 1,
  "unique_artists": 107,
  "estimated_value": 7394.51,
  "top_genre": "Rock",
  "oldest_release_year": 1957,
  "newest_release_year": 2025,
  "most_collected_artist": {
    "name": "Taylor Swift",
    "count": 24
  },
  "added_this_year": 139
}

Documentation Index

Fetch the complete documentation index at: https://docs.rewind.rest/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

​
date
string

Single day (YYYY-MM-DD). Overrides from/to.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2025-02-17"

​
from
string

Range start, inclusive (ISO 8601)

Example:

"2025-02-01T00:00:00Z"

​
to
string

Range end, inclusive (ISO 8601)

Example:

"2025-02-28T23:59:59Z"

Response

Collection statistics

​
total_items
number
required
​
wantlist_count
number | null
required
​
unique_artists
number | null
required
​
estimated_value
number | null
required
​
top_genre
string | null
required
​
oldest_release_year
number | null
required
​
newest_release_year
number | null
required
​
added_this_year
number | null
required
​
by_format
any
​
most_collected_artist
any