# Sweetwater Scraper (`crawlerbros/sweetwater-scraper`) Actor

Scrape Sweetwater.com - the leading online music gear retailer. Search products by keyword, browse by category, filter by brand, price, and stock status. Extracts product name, brand, SKU, price, ratings, reviews, features, and more.

- **URL**: https://apify.com/crawlerbros/sweetwater-scraper.md
- **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Sweetwater Scraper

Scrape **Sweetwater.com** — the USA's leading online music instrument and pro audio retailer. Search products by keyword or browse by category. Extracts product name, brand, SKU, price, stock status, ratings, reviews, and more.

### What this actor does

- **Search mode** — find products by keyword (e.g., `electric guitar`, `fender stratocaster`, `studio microphone`, `drum kit`)
- **Browse mode** — browse a specific category (Electric Guitars, Microphones, Audio Interfaces, etc.)
- **Filter** — narrow results by brand, price range (USD), and in-stock status
- **Pagination** — automatically pages through all results up to your `maxItems` limit

No authentication required. Uses TLS fingerprint impersonation (curl\_cffi chrome131) to bypass basic bot detection.

### Output fields

Each product record contains:

| Field | Type | Description |
|---|---|---|
| `name` | string | Product name |
| `brand` | string | Manufacturer/brand name |
| `productType` | string | Generic product-type label (e.g., `Guitar Electric Semi-Hollow`, `Microphone Condenser`) |
| `sku` | string | Sweetwater item ID (e.g., `LPS6B8NH`) |
| `upc` | string | Manufacturer UPC/EAN barcode |
| `url` | string | Full product page URL |
| `imageUrl` | string | Product image URL (full-resolution product photo) |
| `description` | string | Full product description |
| `price` | number | Current price in USD |
| `regularPrice` | number | Original price (only present if discounted) |
| `currency` | string | Always `"USD"` |
| `inStock` | boolean | Whether the product is currently in stock |
| `condition` | string | Item condition: `"New"`, `"Used"`, etc. |
| `hasFreeShipping` | boolean | Whether the product ships free |
| `rating` | number | Average star rating (1–5) |
| `reviewCount` | integer | Total number of customer reviews |
| `category` | string | Top-level product category (e.g., `Guitars`) |
| `subcategory` | string | Subcategory (e.g., `Electric Guitars`, `Solidbody Guitars`) |
| `specialOffer` | string | Promotional offer text, when the product has one (e.g., `Free Eminence IR Sampler Pack! Only at Sweetwater!`) |
| `sweetwaterExclusive` | boolean | Whether it's a Sweetwater Exclusive product |
| `sourceUrl` | string | URL of the page this product was scraped from |
| `scrapedAt` | string | UTC ISO timestamp of when the record was scraped |
| `recordType` | string | Always `"product"` |

### Input options

#### Mode: `search` (default)

Search for products using a keyword.

```json
{
  "mode": "search",
  "searchQuery": "fender stratocaster",
  "brand": "Fender",
  "minPrice": 500,
  "maxPrice": 2000,
  "inStockOnly": true,
  "maxItems": 50
}
```

#### Mode: `byCategory`

Browse products in a specific category.

```json
{
  "mode": "byCategory",
  "category": "microphones",
  "brand": "Shure",
  "maxItems": 100
}
```

#### Available categories

`electric-guitars`, `acoustic-guitars`, `bass-guitars`, `guitar-amplifiers`, `bass-amplifiers`, `drums-percussion`, `keyboards`, `synthesizers`, `midi-controllers`, `microphones`, `headphones`, `studio-monitors`, `audio-interfaces`, `mixers`, `effects-pedals`, `recording-software`, `dj-equipment`, `live-sound`, `cables`, `stands-racks`, `lighting`

#### Sort options (both modes)

| Value | Description |
|---|---|
| `popular` (default) | Most popular |
| `price-asc` | Price: Low to High |
| `price-desc` | Price: High to Low |
| `rating` | Best Rated |
| `newest` | Newest first |

### Example output

```json
{
  "name": "Gibson Les Paul Standard '60s Electric Guitar - Bourbon Burst",
  "brand": "Gibson",
  "sku": "LPS6B8NH",
  "url": "https://www.sweetwater.com/store/detail/LPS6B8NH--gibson-les-paul-standard-60s-bourbon-burst",
  "imageUrl": "https://media.sweetwater.com/m/products/image/92977dcb6fa.png",
  "price": 2799,
  "currency": "USD",
  "inStock": true,
  "rating": 5,
  "reviewCount": 94,
  "category": "Guitars",
  "subcategory": "Solidbody Guitars",
  "sweetwaterExclusive": false,
  "sourceUrl": "https://www.sweetwater.com/shop/guitars/electric-guitars/",
  "scrapedAt": "2026-06-30T12:00:00+00:00",
  "recordType": "product"
}
```

### Use cases

- **Price monitoring** — Track price changes for specific brands or product types
- **Inventory tracking** — Monitor stock status for popular gear
- **Market research** — Analyze product assortment in different music gear categories
- **Competitor analysis** — Compare Sweetwater pricing vs. other retailers
- **Gift research** — Find guitars, keyboards, microphones, or studio gear within budget

### FAQ

**Q: Does this need a Sweetwater account?**
A: No. All scraped data is publicly available on sweetwater.com without login.

**Q: How many products can I get?**
A: Set `maxItems` up to 500. Sweetwater typically has hundreds to thousands of products per category.

**Q: Can I filter by specific brands?**
A: Yes — use the `brand` field. Example: `"brand": "Fender"` will match products where the brand or name contains "Fender" (case-insensitive).

**Q: Why might I get fewer results than expected?**
A: Some categories may have fewer in-stock products if `inStockOnly` is `true`, or your brand/price filters may be narrow.

**Q: Does this support international pricing?**
A: Sweetwater ships within the USA and prices are always in USD.

### Data source

This actor scrapes publicly available product listing pages on [sweetwater.com](https://www.sweetwater.com). Sweetwater is a registered trademark of Sweetwater Sound, Inc. This actor is not affiliated with or endorsed by Sweetwater.

# Actor input Schema

## `mode` (type: `string`):

Search by keyword or browse a specific category.

## `searchQuery` (type: `string`):

Free-text search query for products (e.g. `electric guitar`, `fender stratocaster`, `studio microphone`).

## `category` (type: `string`):

Product category to browse on Sweetwater.

## `brand` (type: `string`):

Filter results to a specific brand (e.g. `Fender`, `Gibson`, `Shure`, `Yamaha`). Case-insensitive substring match.

## `minPrice` (type: `integer`):

Only include products priced at or above this value (in USD).

## `maxPrice` (type: `integer`):

Only include products priced at or below this value (in USD).

## `inStockOnly` (type: `boolean`):

When enabled, only include products that are currently in stock.

## `sortBy` (type: `string`):

How to sort search results. Applies to both search and category modes.

## `maxItems` (type: `integer`):

Maximum number of products to return.

## Actor input object example

```json
{
  "mode": "search",
  "searchQuery": "electric guitar",
  "category": "electric-guitars",
  "inStockOnly": false,
  "sortBy": "popular",
  "maxItems": 20
}
```

# Actor output Schema

## `products` (type: `string`):

Dataset containing all scraped Sweetwater products.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "searchQuery": "electric guitar",
    "category": "electric-guitars",
    "inStockOnly": false,
    "sortBy": "popular",
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawlerbros/sweetwater-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "searchQuery": "electric guitar",
    "category": "electric-guitars",
    "inStockOnly": False,
    "sortBy": "popular",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("crawlerbros/sweetwater-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "searchQuery": "electric guitar",
  "category": "electric-guitars",
  "inStockOnly": false,
  "sortBy": "popular",
  "maxItems": 20
}' |
apify call crawlerbros/sweetwater-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=crawlerbros/sweetwater-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/sjDleXX37gmGl9rsx/builds/Yy1Jdxb7cFm8n9q4r/openapi.json