# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-guitarpro-com-api-40f91705/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-guitarpro-com-api-40f91705/get_artist_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-guitarpro-com-api-40f91705/get_artist_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-guitarpro-com-api-40f91705/get_latest_tabs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-guitarpro-com-api-40f91705/get_mysongbook_pricing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-guitarpro-com-api-40f91705/get_tab_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-guitarpro-com-api-40f91705/search_tabs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```