Source: https://dinakar-rewind.docs.pageloop.ai/api-reference/collecting/getcollectingcrossreference

# Collection-listening cross-reference

GET `https://api.rewind.rest/v1/collecting/cross-reference`

Cross-references vinyl collection with Last.fm listening data showing play counts and match confidence.

## Authorization

#### Authorization (header, string, required)

API key. Read keys (rw\_live\_...) access GET endpoints. Admin keys (rw\_admin\_...) access all endpoints.

## Query Parameters

#### page (query, integer)

#### limit (query, integer)

#### sort (query, string)

#### filter (query, string)

## Response

#### 200

Cross-reference data with summary stats

#### data (array of object, required)

#### properties

#### collection (object, required)

#### listening (object, required)

#### summary (object, required)

#### properties

#### total\_matches (number, required)

#### listen\_rate (number, required)

#### unlistened\_count (number, required)

#### pagination (object, required)

#### properties

#### page (integer, required)

#### limit (integer, required)

#### total (integer, required)

#### total\_pages (integer, required)

#### 401

Unauthorized

#### error (string, required)

#### status (integer, required)

#### 500

Internal server error

#### error (string, required)

#### status (integer, required)

#### Request

```bash cURL
curl -X GET 'https://api.rewind.rest/v1/collecting/cross-reference' \
  -H 'Authorization: Bearer <token>'
```

```javascript JavaScript
const res = await fetch('https://api.rewind.rest/v1/collecting/cross-reference', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>',
  },
});
const data = await res.json();
```

```python Python
import requests

res = requests.get(
    'https://api.rewind.rest/v1/collecting/cross-reference',
    headers={'Authorization': 'Bearer <token>'}
)
data = res.json()
```

#### Response

```json 200
{
  "data": [
    {
      "collection": {
        "id": "\u2026",
        "discogs_id": "\u2026",
        "title": "\u2026",
        "artists": "\u2026",
        "year": "\u2026",
        "format": "\u2026",
        "genres": "\u2026",
        "styles": "\u2026",
        "image": "\u2026",
        "date_added": "\u2026",
        "rating": "\u2026",
        "discogs_url": "\u2026"
      },
      "listening": {
        "album_name": "\u2026",
        "artist_name": "\u2026",
        "play_count": "\u2026",
        "last_played": "\u2026",
        "match_type": "\u2026",
        "match_confidence": "\u2026"
      }
    }
  ],
  "summary": {
    "total_matches": 0,
    "listen_rate": 0,
    "unlistened_count": 0
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8
  }
}
```

```json 401
{
  "error": "Not found",
  "status": 404
}
```

```json 500
{
  "error": "Not found",
  "status": 404
}
```