# Merchbar Music Merch API

> Merchbar band merch and vinyl: genres, artist pages, item prices and sizes, new arrivals

- Vendor: `merchbarmusicmerchapi` · version 1.0 · category Music · tags merchbar api, band merch api, vinyl records api, music merchandise api, artist merch api, concert shirts api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/merchbarmusicmerchapi
- This document: https://apiclay.com/docs/merchbarmusicmerchapi.md
- OpenAPI 3.1: https://apiclay.com/api/merchbarmusicmerchapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `merchbarmusicmerchapi`
- Updated: 2026-11-18

## About

## Merchbar Music Merch API

The catalogue behind Merchbar, an official music-merchandise store: the genre list with chart text and top item ids; an artist page with bio, images, related artists and item counts by category (shirts, vinyl, CDs, hoodies and more); one item by slug with price, sale price, stock, sizes and variants, description, shipping and Spotify links; the promoted items; and the newest items in a category.

Data comes from **merchbar.com** (https://www.merchbar.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/genres`, `/artist?slug=david-bowie` for counts, `/promoted` or `/new?category=Vinyl` for items, then `/item?slug=`.

### Routes

#### GET `/genres` - Genres
No parameters.

Returns: `data` array: `name`, `slug`, `id`, `chart_description`, `top_merch_ids`, `header_image`.

#### GET `/artist` - Artist
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| slug | path | string | yes | Artist slug from merchbar.com//, e.g. `david-bowie`. |

Returns: `brand`: `name`, `id`, `genre_slug`, `bio`, images, `merch_count`, `merch_count_by_category` (visible and available per category), `related_brands`, `collection`.

#### GET `/item` - Item
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| slug | path | string | yes | Item `slug` from `/promoted` or `/new`. |

Returns: `merch`: `title`, `brand_name`, `type`, `price`, `sale_price`, `quantity`, `status`, `description`, `image`, `tags`, `is_vinyl`, `ship_date`, `shipping_flat_rate_US`, `international_shipping`, `spotify_uri`, and `variants` (size, price, SKU). About 60 KB.

#### GET `/promoted` - Promoted items
No parameters.

Returns: `merch` array of featured items with the same fields as `/item` plus `variants`. Can be about 1 MB.

#### GET `/new` - New in category
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| category | path | string | yes | `Vinyl`, `Shirts`, `CD`, `Sweatshirts`, `Accessories` and other category names. |

Returns: `merch` array of the newest items in that category.

### Caveats

- Prices are in US dollars as shown on merchbar.com. Artist names, images and product photos belong to the artists and their licensors.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by merchbar.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /genres — Genres
- Gateway: `GET https://api.apiclay.com/v1/api/merchbarmusicmerchapi/genres`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /artist — Artist
- Gateway: `GET https://api.apiclay.com/v1/api/merchbarmusicmerchapi/artist`
- Public query params: `slug` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /item — Item
- Gateway: `GET https://api.apiclay.com/v1/api/merchbarmusicmerchapi/item`
- Public query params: `slug` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /promoted — Promoted items
- Gateway: `GET https://api.apiclay.com/v1/api/merchbarmusicmerchapi/promoted`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /new — New in category
- Gateway: `GET https://api.apiclay.com/v1/api/merchbarmusicmerchapi/new`
- Public query params: `category` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/merchbarmusicmerchapi/genres" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
