Source: https://dinakar-rewind.docs.pageloop.ai/api-reference/listening/enrichlisteningartists

# Enrich artists with Apple Music URLs via direct iTunes lookup

POST `https://api.rewind.rest/v1/listening/admin/enrich-artists`

Fallback for artists the track-driven enrichBatch path cannot reach. Searches iTunes with entity=musicArtist and writes apple\_music\_id + apple\_music\_url on a name match. Retries rows whose last attempt was >30 days ago.

## Authorization

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

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

## Response

#### 200

Enrichment results

#### success (boolean, required)

#### results (object, required)

#### properties

#### total (number, required)

#### succeeded (number, required)

#### skipped (number, required)

#### failed (number, required)

#### 401

Unauthorized

#### error (string, required)

#### status (integer, required)

#### Request

```bash cURL
curl -X POST 'https://api.rewind.rest/v1/listening/admin/enrich-artists' \
  -H 'Authorization: Bearer <token>'
```

```javascript JavaScript
const res = await fetch('https://api.rewind.rest/v1/listening/admin/enrich-artists', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <token>',
  },
});
const data = await res.json();
```

```python Python
import requests

res = requests.post(
    'https://api.rewind.rest/v1/listening/admin/enrich-artists',
    headers={'Authorization': 'Bearer <token>'}
)
data = res.json()
```

#### Response

```json 200
{
  "success": true,
  "results": {
    "total": 0,
    "succeeded": 0,
    "skipped": 0,
    "failed": 0
  }
}
```

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