# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/mixesdb/`
**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 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/credits/mixesdb/get-tracklist \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/mixesdb/latest \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/mixesdb/search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```

## Next steps

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