sweetwater.com APIwww.sweetwater.com ↗
Search Sweetwater's catalog of musical instruments and audio gear. Get pricing, availability, ratings, brand filters, and autocomplete suggestions via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/cc4608df-e0c4-4afc-ac6a-8c8cde480aff/search_products?page=1&query=shure+sm7b&hits_per_page=3&in_stock_only=true' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword with optional filtering by brand, category, stock availability, and sorting options. Returns paginated results with product details including pricing, ratings, and availability.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-indexed) |
| brand | string | Filter by brand name (e.g., 'Fender', 'Shure', 'Yamaha') |
| queryrequired | string | Search query (e.g., 'fender stratocaster', 'shure sm7b', 'keyboard') |
| sort_by | string | Sort order: 'price_asc', 'price_desc', 'rating', or empty string for relevance |
| category | string | Filter by top-level category (e.g., 'Guitars', 'Studio & Recording', 'Keyboards & Synthesizers') |
| hits_per_page | integer | Number of results per page (1-100) |
| in_stock_only | boolean | Only return in-stock products |
{
"type": "object",
"fields": {
"query": "search query string",
"products": "array of product objects with object_id, name, brand, description, url, image_url, price, retail_price, catalog_price, condition, in_stock, is_available, free_shipping, rating_average, rating_count, and categories",
"total_hits": "total number of matching products",
"total_pages": "total number of pages available",
"current_page": "current page number (0-indexed)",
"hits_per_page": "number of results per page",
"available_brands": "array of brand name strings available for filtering",
"available_categories": "array of category name strings available for filtering"
},
"sample": {
"data": {
"query": "shure sm7b",
"products": [
{
"url": "https://www.sweetwater.com/store/detail/SM7B--shure-sm7b-cardioid-dynamic-vocal-microphone",
"name": "SM7B Dynamic Cardioid Vocal Microphone",
"brand": "Shure",
"price": 395,
"in_stock": true,
"condition": "New",
"image_url": "https://media.sweetwater.com/m/products/image/6d2c512a92Rov0eryrfK2jdkFSLhFkOUiy3nNCLK.jpg",
"object_id": "SM7B",
"categories": [
"Studio & Recording"
],
"description": "Dynamic Cardioid Vocal Microphone with Bass Roll-off, Presence Boost, Swivel Mount, and Windscreen",
"is_available": true,
"rating_count": 257,
"retail_price": 549,
"catalog_price": 395,
"free_shipping": true,
"rating_average": 5
}
],
"total_hits": 15,
"total_pages": 1,
"current_page": 0,
"hits_per_page": 42,
"available_brands": [
"Shure",
"LM Cases",
"On-Stage"
],
"available_categories": [
"Studio & Recording",
"Video Equipment"
]
},
"status": "success"
}
}About the sweetwater.com API
The Sweetwater API gives developers access to Sweetwater's catalog of musical instruments, audio equipment, and accessories through 2 endpoints. The search_products endpoint returns structured product data including price, retail price, condition, ratings, stock availability, and image URLs, with filtering by brand, category, and sort order. The get_autocomplete endpoint returns ranked search suggestions for partial queries.
Product Search
The search_products endpoint accepts a required query string and several optional filters. You can narrow results by brand (e.g., 'Fender', 'Shure'), category (e.g., 'Guitars', 'Keyboards & Synthesizers'), and set in_stock_only: true to exclude unavailable items. Sorting is controlled via sort_by, which accepts 'price_asc', 'price_desc', 'rating', or an empty string for relevance ordering. Pagination is 0-indexed using page and hits_per_page (1–100 results per page).
Product Response Fields
Each product object in the products array includes object_id, name, brand, description, url, image_url, price, retail_price, catalog_price, and condition. The response also returns total_hits, total_pages, current_page, and hits_per_page for pagination, plus available_brands and available_categories arrays you can use to populate filter UI elements dynamically.
Autocomplete
The get_autocomplete endpoint takes a partial query string and an optional max_results cap (1–20) and returns a suggestions array of matching search terms alongside a count field. This is useful for building search-as-you-type interfaces that surface relevant product names and categories before a full search is executed.
- Compare
pricevsretail_priceacross guitar brands to identify discount patterns - Build an in-stock alert tool using
in_stock_onlyfiltering on a target product query - Populate a music gear price comparison page using
price,brand, andimage_urlfields - Drive a search autocomplete widget using the
get_autocompleteendpoint withmax_results - Aggregate
available_brandsandavailable_categoriesto build a faceted browsing UI - Track new or used gear availability by checking the
conditionfield across paginated results - Pull product URLs and descriptions for affiliate content or gear recommendation tools
| 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 Sweetwater have an official public developer API?+
What product fields does `search_products` return for each result?+
object_id, name, brand, description, url, image_url, price, retail_price, catalog_price, and condition. The response wrapper also includes total_hits, total_pages, available_brands, and available_categories for pagination and filter UI support.Does the API return individual product reviews or review text?+
search_products endpoint returns aggregate product data including pricing and availability but does not expose individual user review text or review counts per product. You can fork this API on Parse and revise it to add an endpoint that retrieves per-product review content.How does pagination work in `search_products`?+
page to the desired page number starting from 0, and use hits_per_page (between 1 and 100) to control page size. The response returns total_hits and total_pages so you can determine how many pages exist for a given query.Can I retrieve a specific product by its ID or SKU?+
search_products and autocomplete via get_autocomplete, but does not expose a direct product-lookup endpoint by SKU, object ID, or URL. You can fork this API on Parse and revise it to add a dedicated product detail endpoint.