# Traxsource — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_all_genres \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_artist_tracks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_just_added \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_label_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_release_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_top100_singles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_top100_tracks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_track_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/get_upcoming_releases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-traxsource-com-api-0123da1a/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","term":"<string>","type":"<string>"}'
```