musiciansfriend.com APImusiciansfriend.com ↗
Search Musician's Friend catalog, browse categories, fetch product details, check stock, and retrieve daily deals via 6 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/a822d314-b462-4b1b-bd66-2d7500fb4406/search_products?sort=bS&limit=24&query=guitar&offset=0' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword. Returns a paginated list of products with basic info including name, price, brand, and ratings.
| Param | Type | Description |
|---|---|---|
| sort | string | Sort key. Accepted values: r (relevance), bS (best sellers), pHL (price high to low), pLH (price low to high). |
| limit | integer | Number of results per page. |
| queryrequired | string | Search keyword. |
| offset | integer | Result offset for pagination. |
{
"type": "object",
"fields": {
"query": "search keyword echoed back",
"products": "array of product objects with name, product_id, sku, url, image, price, original_price, brand, rating, review_count",
"total_count": "total number of matching products as a string, or null"
},
"sample": {
"data": {
"query": "guitar",
"products": [
{
"sku": "site1skuM19477000003000",
"url": "https://www.musiciansfriend.com/guitars/prs-se-studio-standard-electric-guitar",
"name": "PRS SE Studio Standard Electric Guitar",
"brand": "PRS",
"image": "https://media.musiciansfriend.com/is/image/MMGS7/SE-Studio-Standard-Electric-Guitar-Silvertone-Gray/M19477000003000-00-400x400.jpg",
"price": "599.0",
"rating": "null",
"product_id": "site1prodM19477",
"review_count": "0",
"original_price": "849.0"
}
],
"total_count": "548"
},
"status": "success"
}
}About the musiciansfriend.com API
The Musician's Friend API provides 6 endpoints for querying the full instrument and gear catalog, including keyword search via search_products, category browsing, product detail lookup, facet-based filtering, stock availability checks, and the daily 'Stupid Deal of the Day' promotion. Responses include structured fields like price, original_price, brand, rating, review_count, specifications, and delivery estimates, covering everything needed to build price-tracking or product-discovery tools against Musician's Friend's catalog.
Search and Browse
The search_products endpoint accepts a required query string plus optional sort, limit, and offset parameters for pagination. It returns a products array with fields including name, product_id, sku, url, image, price, original_price, brand, rating, and review_count, alongside a total_count for the full result set. The sort parameter accepts four values: r (relevance), bS (best sellers), pHL (price high to low), and pLH (price low to high).
Category and Facet Filtering
get_category_products browses by a category_id (the N parameter value, e.g. '200798'), returning products, a categories array of subcategories with display names and result counts, and a facets array for further filtering. The filter_products endpoint accepts space-separated facet_ids to combine filters — for example, combining a brand facet ID with a condition facet ID narrows results to used gear from a specific brand. Both endpoints support the same sort, limit, and offset pagination controls.
Product Details and Availability
get_product_details takes a product_id in the format site1prod followed by an alphanumeric code and returns a details object with stock status, UPC, and SKU info; a description string; category_info with dept, category, and subcategory; and a specifications key-value object for technical attributes. get_product_availability checks real-time stock for a specific sku_id, returning is_eligible, free_shipping, delivery_date as a Unix timestamp in milliseconds, and an availability_message HTML string with a delivery estimate. Availability is calculated against a default shipping destination of ZIP code 10001.
Deals
get_stupid_deal_of_the_day requires no inputs and returns a deals array with fields including name, sku, product_id, price, regular_price, savings, discount_percentage, url, image, rating, and review_count. This endpoint reflects whatever promotion is currently live on the site.
- Track price drops on instruments by polling search_products and comparing price vs. original_price over time.
- Build a gear comparison tool using get_product_details specifications fields across multiple product IDs.
- Monitor the daily deal via get_stupid_deal_of_the_day to alert users when discount_percentage exceeds a threshold.
- Check shipping eligibility and delivery_date estimates for a SKU before surfacing it in a checkout flow.
- Filter used or open-box inventory by combining condition facet IDs in filter_products.
- Enumerate a full brand catalog by passing a brand facet ID to get_category_products and paginating with offset.
- Aggregate review_count and rating data from search results to rank products by community reception.
| 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.