# Guitar Pro — 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.

> Search and retrieve guitar tabs, artist profiles, and detailed song metadata from Guitar Pro and mySongBook to find music you want to play. Get pricing information and browse the latest tabs to discover new songs across your favorite artists.

**Category:** Music | **Website:** [guitarpro.com/](https://guitarpro.com/) | **Docs:** [parse.bot/marketplace/40f91705-6f12-422e-8dc5-6f3991e33a94/guitarpro-com-api](https://parse.bot/marketplace/40f91705-6f12-422e-8dc5-6f3991e33a94/guitarpro-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/guitar-pro/`
**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 artist detail

Retrieve an artist profile including name, biography (when available), and their full catalog of tabs. Accepts both tab-catalog artist slugs (e.g. '242-metallica') and roster artist slugs (e.g. '51517-raoul-tchoi'). The scraper tries /tabs/artists/ first, falling back to /artists/p/.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id_slug` | string | Yes | Artist ID-slug from tab detail artist_url or get_artist_list results (e.g. '242-metallica', '51517-raoul-tchoi'). |

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

### Get artist list

Retrieve the Guitar Pro featured artist roster. Returns artists with name, profile URL, and genre/country info. The genre parameter filters the displayed list but may not produce different results for all values.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Genre filter keyword. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/guitar-pro/get-artist-list \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>"}'
```

### Get latest tabs

Retrieve a paginated list of all tabs in the mySongBook catalog sorted alphabetically. Each page contains roughly 100 tabs. Use the page parameter to advance through the full catalog.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number (1-based). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/guitar-pro/get-latest-tabs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### Get mysongbook pricing

Retrieve current mySongBook subscription plans and pricing. Returns all available plan durations with their total price, per-month equivalent, and purchase URL.

**Estimated cost:** Metered

_No parameters required._

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

### Get tab detail

Retrieve full metadata for a specific tab including artist, album, genres, composer, lyricist, sheet music preview images, and links to other arrangements of the same song. The id_slug is available from search or listing results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id_slug` | string | Yes | Tab ID-slug from search or listing results (e.g. '444-highway-to-hell', '426-enter-sandman'). |

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

### Search tabs

Full-text search across the mySongBook catalog by artist name or song title. Returns matching tabs as lightweight summaries with audio preview URLs. Single-page response — no server-side pagination; all matches returned in one call.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword — artist name or song title. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/guitar-pro/search-tabs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"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.