Submit Account

Add an Amazon account to the streaming pool.

Account / Device Label Region

API Reference

The Lossless Addon API serves high-resolution lossless audio streams to LastWave Desktop and compliant DASH players. All audio is fetched from source CDNs and decrypted transparently via CENC/DRM key providers.

Authentication

Client requests are authorized using Addon Tokens. Tokens can be provided as a Bearer token in the Authorization header or via the token query parameter in playback URLs.

Headers

Header	Type	Description
Authorizationstring	optional Bearer token (e.g. `Bearer <token>`)

Query Parameters

Parameter	Type	Description
tokenstring	optional Addon token passed in request URL.

Header Example

Authorization: Bearer <addon_token>

GET /manifest.json

Returns the addon manifest including protocol compatibility, codec support, and metadata used by client apps upon pairing.

Query Parameters

Parameter	Type	Description
tokenstring	optional Addon token for quota verification.

Responses

Status	Description
`200 OK`	Manifest configuration returned successfully.

cURL

curl -X GET "https://lovebitches.clashgram.org/manifest.json"

Response (200 OK)

{
  "id": "amz",
  "name": "Amazon Music",
  "version": "1.0.0",
  "description": "Lossless audio resolver",
  "protocols": ["lastwave-v1", "dash-mpd"],
  "formats": ["flac", "alac", "opus", "aac"],
  "maxQuality": "ultra_hd",
  "atmos": true
}

GET /search

Search catalog tracks, albums, or artists across the provider's regional library.

Query Parameters

Parameter	Type	Description
qstring	required Search query text.
typestring	optional `track`, `album`, or `artist`. Defaults to `track`.
limitinteger	optional Max results (1-50). Default is `20`.

cURL

curl -X GET "https://lovebitches.clashgram.org/search?q=Daft+Punk&type=track"

Response (200 OK)

{
  "query": "Daft Punk",
  "results": [
    {
      "id": "B00136RB9O",
      "title": "Get Lucky",
      "artist": "Daft Punk feat. Pharrell Williams",
      "album": "Random Access Memories",
      "duration": 369,
      "quality": "ultra_hd",
      "sampleRate": 96000,
      "bitDepth": 24
    }
  ]
}

GET /stream/{id}

Resolves playback URLs and CENC decryption parameters for an individual track. Players can stream directly from the clear MPD manifest URL or consume the audio stream directly.

Path Parameters

Parameter	Type	Description
idstring	required Track ASIN or catalog identifier.

Query Parameters

Parameter	Type	Description
qualitystring	optional Target tier: `lossless`, `hd`, or `ultra_hd`.
atmosboolean	optional Set to `true` to request Dolby Atmos spatial stream.

cURL

curl -X GET "https://lovebitches.clashgram.org/stream/B00136RB9O?quality=ultra_hd"

Response (200 OK)

{
  "status": "ready",
  "trackId": "B00136RB9O",
  "codec": "flac",
  "sampleRate": 96000,
  "bitDepth": 24,
  "bitrate": 3210000,
  "url": "https://lovebitches.clashgram.org/media/B00136RB9O.mpd",
  "cenc": {
    "scheme": "cenc",
    "keyId": "4a7f9c2d1b...",
    "key": "b83ef17c24..."
  }
}

GET /media/{id}.mpd

Dynamically generates a DASH XML manifest for media engines. The manifest references the proxy segment router to stream unencrypted audio in real time.

Path Parameters

Parameter	Type	Description
idstring	required Track ASIN or identifier.

cURL

curl -X GET "https://lovebitches.clashgram.org/media/B00136RB9O.mpd"

Response (200 OK)

<MPD xmlns="urn:mpeg:dash:schema:mpd:2011" type="static">
  <Period>
    <AdaptationSet mimeType="audio/mp4" codecs="flac" sampleRate="96000">
      <Representation id="1" bandwidth="3210000">
        <BaseURL>/seg/B00136RB9O?cdn=...</BaseURL>
        <SegmentBase indexRange="0-845">
          <Initialization range="0-642"/>
        </SegmentBase>
      </Representation>
    </AdaptationSet>
  </Period>
</MPD>

GET /seg/{id}

Range-request proxy and transparent decryptor. Fetches encrypted byte slices from source CDNs, strips CENC sample encryption, and streams raw audio bytes to the client.

Query Parameters

Parameter	Type	Description
cdnstring	required Upstream CDN media locator.
sinteger	required Range start offset in bytes.
einteger	required Range end offset in bytes.
sigstring	required Cryptographic HMAC URL validation token.

cURL

curl -X GET "https://lovebitches.clashgram.org/seg/B00136RB9O?cdn=...&s=0&e=642&sig=..."

POST /api/accounts/login-url

Starts an OAuth authorization session. Generates an Amazon sign-in link with PKCE code challenges to authorize an account without exposing credentials.

Request Body (JSON)

Field	Type	Description
countrystring	optional 2-letter marketplace region code (e.g. `US`, `GB`, `DE`, `JP`). Default is `US`.

cURL

curl -X POST "https://lovebitches.clashgram.org/api/accounts/login-url" \
  -H "Content-Type: application/json" \
  -d '{"country":"US"}'

Response (200 OK)

{
  "oauthUrl": "https://www.amazon.com/ap/oa?...",
  "state": "8f3b2e1a90c4...",
  "country": "US"
}

POST /api/accounts

Saves an authenticated account session to the streaming pool using either the completed OAuth redirect URL or an exported credentials JSON blob.

Request Body (JSON)

Field	Type	Description
namestring	optional Unique label for this account in the pool.
redirectUrlstring	optional Full landing URL returned after Amazon authentication.
credentialsstring	optional Raw JSON credential blob.

cURL

curl -X POST "https://lovebitches.clashgram.org/api/accounts" \
  -H "Content-Type: application/json" \
  -d '{"name":"Device1","redirectUrl":"https://..."}'

Response (200 OK)

{
  "ok": true,
  "name": "Device1",
  "region": "US",
  "tier": "HD",
  "token": {
    "id": "tok_9f8e7d",
    "name": "Device1 Addon"
  }
}

GET /health

Liveness probe verifying that the service and Redis storage backend are operational.

Responses

Status	Description
`200 OK`	System operational.

cURL

curl -X GET "https://lovebitches.clashgram.org/health"

Response (200 OK)

{
  "ok": true,
  "storage": "redis",
  "version": "1.0.0"
}

Addons

Configured stream keys and token quotas.

Name	Status	Daily Quota	Expires	Addon URL

Primary URL:

Loading...

Amazon Accounts

Session pool for licensing and manifest requests.

0 accounts

Name	Account	Tier	Region	Customer ID	Status

+ Add Account

Label Region

Addons

Amazon Accounts

Search Cache

Storage Engine

Account Submission Portal

Submit Account

Console

API Reference

Authentication

Addons

Amazon Accounts

Search Cache

Storage Engine

Account Submission Portal