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

> Browse Ibanez bass guitar series and models, view detailed specifications, find authorized dealers, and discover the latest news and artist endorsements. Search and filter across Ibanez's complete bass catalog to find the perfect instrument for your needs.

**Category:** Music | **Website:** [ibanez.com/](https://ibanez.com/) | **Docs:** [parse.bot/marketplace/cd8fbce3-3973-456f-9a4c-7cf67a6dd952/ibanez-com-api](https://parse.bot/marketplace/cd8fbce3-3973-456f-9a4c-7cf67a6dd952/ibanez-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-ibanez-com-api-cd8fbce3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_artists

Fetch the list of Ibanez endorsed bass artists from the electric basses artist category. Returns artist names and URLs to their detail pages on the Ibanez website.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/get_artists \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_bass_guitar_detail

Fetch full specifications and details for a specific bass guitar model. Returns the complete product record including body material, neck type, pickups, fretboard, scale length, hardware, electronics, and all regional variants. The product_id is the _key field from list_bass_guitars_by_series results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `product_id` | string | Yes | The product identifier (_key field) from list_bass_guitars_by_series results. Format is typically lowercase: modelcode_makercode_version (e.g. 'sr6605_00_01', 'icb720fm_1p_01'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/get_bass_guitar_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id":"<string>"}'
```

### get_dealers

Fetch the list of authorized Ibanez dealers in the USA, organized by state. Returns all states with their dealers including name, address, phone number, and website. No pagination — the full dealer list is returned.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/get_dealers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_news

Fetch the latest Ibanez news and featured product announcements from the USA news page. Returns news items with titles and URLs to the full articles or product pages.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/get_news \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_bass_guitars

Fetch all electric bass guitars listed on the site by aggregating products from every series. Returns the complete catalog with full specifications for each model. May be slow as it fetches from every series sequentially. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/list_bass_guitars \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_bass_guitars_by_series

List all bass guitars within a specific series. Returns detailed product objects for every model in the series, including full specifications (body material, pickups, neck type, fretboard, scale length, etc.). The series_id comes from the _key field of list_bass_series results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `series_id` | string | Yes | The series identifier from the _key field of list_bass_series results (e.g. 'sr_prestige', 'btb_standard', 'mikro_bass'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/list_bass_guitars_by_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"series_id":"<string>"}'
```

### list_bass_series

List all electric bass guitar series available on the Ibanez USA website. Each series groups related bass models (e.g. SR Prestige, BTB Standard). Returns the full catalog of series with identifiers, display names, and descriptions. No pagination — the full list is returned in a single response.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/list_bass_series \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_products

Search for bass guitars by model name or keyword. Searches across model numbers, product names, and product codes from the full catalog. Returns matching products with full specifications. The search is case-insensitive and matches partial strings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword to match against model numbers and product codes (e.g. 'SR', 'BTB', 'GSR', 'ICB'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ibanez-com-api-cd8fbce3/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```