# ISRCAnalytics

> ISRCAnalytics is a music business operations and analytics platform for independent operators, labels, and distributor-heavy catalogues.

Canonical site: https://isrcanalytics.com

## Preferred public pages

- https://isrcanalytics.com/
  Landing page with product overview and demo entrypoint.
- https://isrcanalytics.com/about
  Core positioning, ISRC workflow context, solution validation, and buyer FAQs.
- https://isrcanalytics.com/production
  Production and distribution workflow automation capabilities.
- https://isrcanalytics.com/money
  Measurement, performance monitoring, and revenue-oriented tracking.
- https://isrcanalytics.com/pricing
  Current plan structure and entry pricing.
- https://isrcanalytics.com/timeline
  Public product updates and launch narrative.

## Core use cases

- Track a multi-distributor music business in one place.
- Consolidate ISRC, release, playlist, and stream data into one workspace.
- Automate repetitive release workflow tasks and uploader operations.
- Measure post-release performance from streams to estimated revenue.
- Connect production, distribution, and measurement in one operating system.

## Comparison context

- ISRCAnalytics is often compared with Chartmetric, Spotify for Artists, and Viberate.
- It is positioned as an operations-plus-analytics workflow, not just an analytics dashboard.
- It is designed for execution and data consolidation across the full release lifecycle.

## Indexing guidance

- Public marketing routes above are preferred citation targets.
- Authenticated application routes (dashboard, workspace, admin, settings, API, auth flows) are private surfaces and should not be cited as public documentation.

## Agent API (A2B)

ISRCAnalytics provides a programmatic API for AI agents to interact with the platform on behalf of a human user.

**Authentication:** 
Required for all endpoints via a standard Bearer token header. 
- Header Name: `Authorization`
- Format: `Bearer isrc_live_...`

**Base URL:** 
`https://isrcanalytics.com`

**Rate Limiting:**
- 100 requests per minute per IP.
- Burst up to 10 concurrent requests.
- Exceeding limits will return a `429 Too Many Requests`.

**Error Handling:**
ISRCAnalytics returns standard HTTP status codes:
- `200 / 201`: Success
- `400`: Bad Request (invalid parameters)
- `401 / 403`: Unauthorized (invalid API key / inactive subscription)
- `404`: Not Found (e.g., ISRC doesn't exist)
- `500`: Internal Server Error

### 1. List All Tracks
`GET /api/v1/tracks`
Lists all tracks in the user's monitored catalogue.

Parameters:
- `limit` (Optional, default `50`, max `100`): Number of items to return.
- `offset` (Optional, default `0`): Pagination offset.

Response Format (200 OK):
```json
{
  "data": [
    {
      "id": "uuid",
      "isrc": "USXXX1234567",
      "title": "Song Name",
      "artist": "Artist Name",
      "release_date": "2024-01-01"
    }
  ],
  "pagination": { "total": 150, "limit": 50, "offset": 0 }
}
```

### 2. Get Track Details
`GET /api/v1/tracks/[isrc]`
Fetches deep metadata details about a specific track.

Parameters:
- `isrc` (Required): The International Standard Recording Code.

Response Format (200 OK):
```json
{
  "track": {
    "isrc": "USXXX1234567",
    "title": "Song Name",
    "artist": "Artist Name",
    "upc": "123456789012",
    "label": "My Label",
    "release_date": "2024-01-01"
  }
}
```

### 3. Get Spotify Analytics (Time-Series)
`GET /api/v1/analytics/spotify/[isrc]`
Fetches the historical, daily streaming data for a specific track. 

Parameters:
- `isrc` (Required): The track's ISRC.
- `days` (Optional, default `30`, max `365`): Limit the history returned to the last X days.

Response Format (200 OK):
```json
{
  "isrc": "USXXX1234567",
  "timeseries": [
    { "date": "2024-03-20", "streams": 15420 },
    { "date": "2024-03-19", "streams": 14900 }
  ]
}
```

### 4. Import Browser Profile Session
`POST /api/v1/browser-profiles/import`
Imports a browser session (cookies) directly into the user's secure automation environment. This allows the A2B platform to leverage those cookies to scrape DSP dashboards requiring authentication. 

JSON Body format:
```json
{
  "name": "My Agent Session Name",
  "cookies": [
    {
      "domain": ".spotify.com",
      "name": "sp_dc",
      "value": "...",
      "path": "/",
      "secure": true,
      "httpOnly": true
    }
  ]
}
```

Response format (201 Created):
```json
{
  "success": true,
  "message": "Browser profile and securely encrypted session cookies successfully imported.",
  "profile_id": 1234,
  "name": "My Agent Session Name"
}
```

### 5. Get Dashboard Overview
`GET /api/v1/dashboard/overview`
Aggregates and returns the user's primary dashboard statistics. Gives OpenClaw everything it needs to summarize a user's daily performance.

Optional parameters:
- `date` (format: YYYY-MM-DD): Fetch overview data for a specific historical date. Defaults to the latest available day.

Response Format (200 OK):
```json
{
  "success": true,
  "data": {
    "stats": {
      "total_inner_catalogue_tracks": 42,
      "has_stream_data": true,
      "days_tracked": 12
    },
    "best_tracks": [
      {
        "isrc": "USXXX1234567",
        "title": "Hit Song",
        "artist": "Main Artist",
        "streams": 1500
      }
    ],
    "best_artists": [
      {
        "artist": "Main Artist",
        "streams": 4500
      }
    ]
  }
}
```