# Guitarcenter — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Guitar Center's electric guitar catalog to instantly access product listings with pricing, customer reviews, and detailed specifications across different variants. Compare guitars and find the perfect instrument with complete product information all in one place.

**Category:** E-commerce | **Website:** [guitarcenter.com/](https://guitarcenter.com/) | **Docs:** [parse.bot/marketplace/226c8166-bcfc-4400-b110-7f1298344279/guitarcenter-com-api](https://parse.bot/marketplace/226c8166-bcfc-4400-b110-7f1298344279/guitarcenter-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-guitarcenter-com-api-226c8166/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_product

Retrieve detailed information about a specific electric guitar product by its SKU ID. Returns full specifications, store availability, identifiers (UPC, part number), review data, and all available color/finish variants.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sku_id` | string | Yes | The product SKU ID, with or without the 'site5' prefix (e.g. 'site51500000337994' or '1500000337994'). Available from search_products results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-guitarcenter-com-api-226c8166/get_product \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sku_id":"<string>"}'
```

### search_products

Search electric guitar products on Guitar Center with optional filters for brand, condition, price range, and text query. Results are paginated and auto-iterated. Each product includes pricing, reviews, images, and available color/finish variants. Default category is Electric Guitars but can be changed to browse other instrument categories.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `brand` | string | No | Filter by brand name (e.g. Fender, Gibson, PRS, Epiphone, Squier, Jackson, Ibanez). Case-sensitive, must match the brand as listed on Guitar Center. |
| `category` | string | No | Category path filter using Guitar Center's hierarchy format (e.g. 'Guitars > Electric Guitars'). Defaults to Electric Guitars. |
| `condition` | string | No | Filter by product condition. Accepted values: New, Used. Empty string means no filter. |
| `hits_per_page` | integer | No | Number of products per page (1-100). |
| `max_price` | string | No | Maximum price filter in USD (e.g. '1000'). Empty string means no maximum. |
| `min_price` | string | No | Minimum price filter in USD (e.g. '100'). Empty string means no minimum. |
| `page` | integer | No | Zero-based page number for pagination. |
| `query` | string | No | Free-text search query to filter products by name, brand, or keywords. |
| `sort_by` | string | No | Sort order for results. Empty string uses default relevance sorting. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-guitarcenter-com-api-226c8166/search_products \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"brand":"<string>","category":"<string>","condition":"<string>","hits_per_page":"<integer>","max_price":"<string>","min_price":"<string>","page":"<integer>","query":"<string>","sort_by":"<string>"}'
```
