# Traxsource — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access Traxsource's music catalog to browse top tracks and singles, explore genres, search for music, and discover newly added releases and artist discographies. Get detailed information about specific tracks, releases, and artists to find the music you're looking for.

**Category:** Music | **Website:** [traxsource.com/](https://traxsource.com/) | **Docs:** [parse.bot/marketplace/0123da1a-5d2d-4970-bf6f-398f792855a1/traxsource-com-api](https://parse.bot/marketplace/0123da1a-5d2d-4970-bf6f-398f792855a1/traxsource-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get all genres

Returns all available genres on Traxsource with their IDs, slugs, names, and URLs. Single page with the full genre catalog.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-all-genres \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get artist tracks

Returns tracks for an artist by their ID and URL slug. Includes artist bio when available. Results are paginated with up to 50 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `artist_id` | string | Yes | Numeric artist ID (e.g. "24228"). |
| `page` | integer | No | Page number for pagination. |
| `slug` | string | Yes | Artist URL slug from their Traxsource URL path (e.g. "dj-pp"). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-artist-tracks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"artist_id":"<string>","page":"<integer>","slug":"<string>"}'
```

### Get just added

Returns the most recently added tracks or releases on Traxsource, filterable by time period and genre. Results are paginated with up to 50 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre_id` | string | No | Numeric genre ID to filter results (e.g. "4" for House, "13" for Deep House). Corresponds to IDs from the genre catalog. |
| `page` | integer | No | Page number for pagination. |
| `period` | string | No | Time period filter: "today", "yesterday", "7d", "30d". |
| `view` | string | No | View type: "tracks" or "releases". |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-just-added \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"genre_id":"<string>","page":"<integer>","period":"<string>","view":"<string>"}'
```

### Get label details

Returns a record label's full profile from Traxsource, including its track catalog (paginated, 10 per page) and any upcoming/pre-order releases. The tracks array reflects the requested page; the upcoming array always shows the label's current pre-orders regardless of page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `label_id` | string | Yes | Numeric label ID (e.g. "45256"). |
| `label_slug` | string | Yes | Label URL slug from its Traxsource URL path (e.g. "black-box-underground"). |
| `page` | integer | No | Page number for the tracks listing. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-label-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"label_id":"<string>","label_slug":"<string>","page":"<integer>"}'
```

### Get release detail

Returns details for a specific release (single, EP, or album) including its track listing, label, catalog number, and release date. Requires both title_id and slug from the release's Traxsource URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Release URL slug from its Traxsource URL path (e.g. "that-funky-rhythm"). |
| `title_id` | string | Yes | Numeric release/title ID (e.g. "2785854"). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-release-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","title_id":"<string>"}'
```

### Get top100 singles

Returns the Traxsource Top 100 singles/releases chart with position, title, artists, label, and release date. Single page, up to 100 items.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-top100-singles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get top100 tracks

Returns the Traxsource Top 100 tracks chart, optionally filtered by genre. Each track includes title, artists, label, genre, duration, release date, and price. The chart is a single page of up to 100 items — no pagination parameter.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre_id` | string | No | Numeric genre ID to filter chart results (e.g. "4" for House, "13" for Deep House). Corresponds to IDs from the genre catalog. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-top100-tracks \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"genre_id":"<string>"}'
```

### Get track detail

Returns full metadata for a single track by its ID and URL slug, including BPM, key, duration, genre, label, and DJ chart appearances. Requires both track_id and slug from the track's Traxsource URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Track URL slug from the track's Traxsource URL path (e.g. "that-funky-rhythm-extended-mix"). |
| `track_id` | string | Yes | Numeric track ID (e.g. "14660532"). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-track-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>","track_id":"<string>"}'
```

### Get upcoming releases

Returns upcoming/pre-order releases from Traxsource. Without label filtering, returns all pre-order tracks across the catalog. With label_id and label_slug, scopes results to a specific record label's pre-orders. Results are paginated with up to 10 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre_id` | string | No | Numeric genre ID to filter results (e.g. "4" for House, "13" for Deep House). Corresponds to IDs from the genre catalog. |
| `label_id` | string | No | Numeric label ID to filter by a specific record label (e.g. "49"). |
| `label_slug` | string | No | Label URL slug from its Traxsource URL path (e.g. "z-records"). Required when label_id is provided. |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/get-upcoming-releases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"genre_id":"<string>","label_id":"<string>","label_slug":"<string>","page":"<integer>"}'
```

### Search

Search Traxsource for tracks or releases by keyword. Returns paginated results with up to 50 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `term` | string | Yes | Search keyword. |
| `type` | string | No | Content type to search: "tracks" or "releases". |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/traxsource/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","term":"<string>","type":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.