# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/guitarcenter/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/guitarcenter/get-product \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/guitarcenter/search-products \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.