# Mixesdb — 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.

> Discover and explore DJ mix tracklists by searching the MixesDB database or browsing recently added mixes to find the songs played in your favorite sets. Get detailed track information for any mix, including song titles and artist names.

**Category:** Music | **Website:** [www.mixesdb.com/](https://www.mixesdb.com/) | **Docs:** [parse.bot/marketplace/901fa1d0-bc19-42b9-a897-ecfcab28b3aa/mixesdb-com-api](https://parse.bot/marketplace/901fa1d0-bc19-42b9-a897-ecfcab28b3aa/mixesdb-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-mixesdb-com-api-901fa1d0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_tracklist

Retrieve the full tracklist and metadata for a mix page. Each track entry is parsed into position/cue, artist, title, remix/mix name, and record label. Unknown or ID entries appear as explicit placeholders with null fields and a raw marker. The tracklist completeness status reflects the wiki's own annotation (complete, incomplete, or null when unmarked). Also extracts duration, player links, genre tags, notes, and extraction warnings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full MixesDB mix page URL (e.g. https://www.mixesdb.com/w/2026-07-19_-_Charlotte_de_Witte_@_Tomorrowland_-_Consiencia). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mixesdb-com-api-901fa1d0/get_tracklist \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### latest

List recently added or updated mix pages, deduplicated by page title (most recent edit per page kept). Returns page URLs, titles, timestamps, and change type (new or edit). Excludes non-article namespace pages (Help, Category, Template, User, etc.). By default only dated pages (titles starting with YYYY-MM-DD) are returned; set include_undated to true to include all.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `change_type` | string | No | Filter by change type: 'new' for newly created pages, 'edit' for edited pages, 'all' for both. |
| `include_undated` | boolean | No | When false (default), only pages whose title starts with a full YYYY-MM-DD date are returned. Set true to include undated pages. |
| `limit` | integer | No | Maximum number of unique pages to return (1-50). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mixesdb-com-api-901fa1d0/latest \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"change_type":"<string>","include_undated":"<boolean>","limit":"<integer>"}'
```

### search

Full-text search across all mix pages. Returns matching page titles, URLs, text snippets, and total hit count. Results are ordered by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return (1-50). |
| `query` | string | Yes | Search text to match against mix page content and titles. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-mixesdb-com-api-901fa1d0/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```