Collecting

Collection stats

GET https://api.rewind.rest/v1/collecting/stats

Aggregate statistics for the vinyl collection. Supports optional date filtering to scope stats to items added within a time period.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

datequerystring

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

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

Response

application/json

Collection statistics

total_itemsnumberrequired

by_formatobject

wantlist_countnumberrequired

unique_artistsnumberrequired

estimated_valuenumberrequired

top_genrestringrequired

oldest_release_yearnumberrequired

newest_release_yearnumberrequired

most_collected_artistobject

added_this_yearnumberrequired

cURL

curl -X GET 'https://api.rewind.rest/v1/collecting/stats' \
  -H 'Authorization: Bearer <token>'

200

{
  "total_items": 0,
  "by_format": {},
  "wantlist_count": 0,
  "unique_artists": 0,
  "estimated_value": 0,
  "top_genre": "string",
  "oldest_release_year": 0,
  "newest_release_year": 0,
  "most_collected_artist": {},
  "added_this_year": 0
}