merchbar.com APImerchbar.com ↗
Access Merchbar product listings, artist merch, pricing, variants, and sale data via 6 endpoints covering vinyl, CDs, apparel, and accessories.
curl -X GET 'https://api.parse.bot/scraper/49a6072a-d20b-4890-bc1e-1f8b3d6f1fce/search_products?limit=5&query=Metallica' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional filters and sorting. Returns paginated results from the Merchbar catalog.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| sort | string | Sort order. Accepted values: relevance, price_asc, price_desc, newest, discount. |
| limit | integer | Number of results per page. |
| query | string | Search keyword. Use '*' to match all products. |
| on_sale | boolean | Filter for products currently on sale. |
| category | string | Category to filter by (e.g., Vinyl, CD, Shirts). |
{
"type": "object",
"fields": {
"page": "integer current page number",
"per_page": "integer results per page",
"products": "array of product objects with id, name, brand, brand_id, price, sale_price, effective_price, thumbnail, url, status, tags",
"total_found": "integer total matching products"
},
"sample": {
"data": {
"page": 1,
"per_page": 5,
"products": [
{
"id": "merch-5976098",
"url": "https://www.merchbar.com/pop/taylor-swift/taylor-swift-lp-folklore-vinyl-5976098",
"name": "Taylor Swift Folklore (2LP/Beige) Vinyl",
"tags": [
"vinyl"
],
"brand": "Taylor Swift",
"price": 63.73,
"status": "AVAILABLE",
"brand_id": 12363,
"thumbnail": "https://imgproxy-images.merchbar.com/insecure/rs:fit:390:390:0/f:webp/...",
"sale_price": null,
"effective_price": 63.73
}
],
"total_found": 31
},
"status": "success"
}
}About the merchbar.com API
The Merchbar API gives developers programmatic access to music merchandise data across 6 endpoints, covering search, artist-specific listings, product details, new arrivals, and sale tracking. The get_product_details endpoint returns per-product fields including SKU, UPC, variants, images, and currency — useful for building price trackers, fan stores, or merch aggregators on top of Merchbar's catalog.
Search and Filter the Catalog
The search_products endpoint accepts a query string (use * to match everything), optional category filters like Vinyl, CD, or Shirts, an on_sale boolean, and a sort parameter with values including price_asc, price_desc, newest, and discount. Results are paginated via page and limit, and each product object in the products array carries id, name, brand, brand_id, price, sale_price, effective_price, thumbnail, url, status, and tags.
Artist-Scoped Queries
To pull merch for a specific artist, use get_artist_products with either an artist_id (numeric brand ID) or an artist_query string. If you only have a name, get_artist_id resolves it to a brand_id and brand_name — that brand_id can then be passed to get_artist_products, get_new_arrivals, or get_on_sale_products to scope any of those feeds to a single artist.
Product Detail and Variant Data
get_product_details takes a full product URL or path slug and returns the richest per-item data: sku, upc, name, price, currency, status, an artist object with id, name, and url, a variants array, and an images array with multiple sizes. This endpoint is the right choice when you need listing-level detail beyond what the list endpoints expose.
New Arrivals and Sale Feeds
get_new_arrivals returns products sorted by creation date descending, optionally scoped by artist_id or a keyword query. get_on_sale_products returns discounted items sorted by discount percentage descending, also filterable by artist_id or query. Both share the same paginated response shape — page, per_page, total_found, and a products array — making it straightforward to combine them in a single feed.
- Track price drops and sale events for a specific artist using
get_on_sale_productsfiltered byartist_id. - Build a new-release merch alert system using
get_new_arrivalsfiltered by artist or keyword. - Aggregate vinyl listings across multiple artists by combining
search_productswithcategory=Vinyl. - Resolve artist names to brand IDs via
get_artist_idfor use in downstream artist-scoped queries. - Pull UPC and variant data from
get_product_detailsto cross-reference merch against music databases. - Populate a fan site's merch section using
get_artist_productswith sort and category filtering. - Monitor
effective_priceacross paginated catalog results to detect consistent pricing patterns by artist.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Merchbar offer an official developer API?+
What does `get_product_details` return beyond what the list endpoints provide?+
get_product_details returns fields not present in list results: sku, upc (GTIN), a full variants array, an images array with multiple sizes, and an artist object containing id, name, and url. The list endpoints return only thumbnail and a single url per product.Can I retrieve customer reviews or ratings for a product?+
Is there a way to filter by multiple categories at once in a single request?+
category parameter on search_products and get_artist_products accepts a single category string per request (e.g., Vinyl or Shirts). To cover multiple categories, you would issue separate requests per category. You can fork this API on Parse and revise it to batch or merge multi-category queries.How fresh is the pricing and availability data?+
status field reflects current availability, and sale_price and effective_price reflect the state of the listing at retrieval time. Merchbar itself aggregates stock from third-party sellers, so availability and pricing can change between requests — treat returned prices as a snapshot, not a guaranteed live quote.