Guitarcenter APIguitarcenter.com ↗
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.
curl -X POST 'https://api.parse.bot/scraper/f12042c4-53c5-4b0b-895a-6796ae939bd7/search_products' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"page": "0",
"query": "stratocaster",
"sort_by": "relevance",
"category": "Guitars > Electric Guitars",
"hits_per_page": "5"
}'Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace guitarcenter-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Guitar Center Electric Guitars API — search, filter, and inspect products."""
from parse_apis.guitarcenter_com_api import GuitarCenter, SortBy, ProductNotFound
client = GuitarCenter()
# Search for Fender Stratocasters, sorted by top rated
for product in client.products.search(query="stratocaster", brand="Fender", sort_by=SortBy.TOP_RATED, limit=3):
print(product.display_name, f"${product.price}", f"Rating: {product.review_rating}/10")
# Get a single product by drilling into search results
guitar = client.products.search(query="les paul", limit=1).first()
if guitar:
print(f"\nFound: {guitar.display_name} by {guitar.brand}")
print(f"Price: ${guitar.price} (list: ${guitar.list_price})")
for variant in guitar.variants[:3]:
print(f" Variant: {variant.display_name} - ${variant.price}")
# Fetch full details for a known product
if guitar:
try:
detail = client.products.get(sku_id=guitar.sku_id)
print(f"\nSpecs: {detail.specs[:100]}...")
print(f"Identifiers: UPC={detail.identifiers.upccode if detail.identifiers else 'N/A'}")
except ProductNotFound as exc:
print(f"Product not found: {exc}")
print("\nExercised: products.search (with brand/sort filters) / products.get / variant access")
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.
| Param | Type | Description |
|---|---|---|
| page | integer | Zero-based page number for pagination. |
| brand | string | Filter by brand name (e.g. Fender, Gibson, PRS, Epiphone, Squier, Jackson, Ibanez). Case-sensitive, must match the brand as listed on Guitar Center. |
| query | string | Free-text search query to filter products by name, brand, or keywords. |
| sort_by | string | Sort order for results. Empty string uses default relevance sorting. |
| category | string | Category path filter using Guitar Center's hierarchy format (e.g. 'Guitars > Electric Guitars'). Defaults to Electric Guitars. |
| condition | string | Filter by product condition. Accepted values: New, Used. Empty string means no filter. |
| max_price | string | Maximum price filter in USD (e.g. '1000'). Empty string means no maximum. |
| min_price | string | Minimum price filter in USD (e.g. '100'). Empty string means no minimum. |
| hits_per_page | integer | Number of products per page (1-100). |
{
"type": "object",
"fields": {
"page": "integer",
"products": "array of product objects with sku_id, display_name, brand, price, list_price, condition, color, image_url, seo_url, review_rating, review_count, features, and variants",
"total_hits": "integer",
"total_pages": "integer",
"hits_per_page": "integer"
},
"sample": {
"data": {
"page": 0,
"products": [
{
"brand": "Fender",
"color": "Burst or Fade",
"price": 849.99,
"sku_id": "site51500000428057",
"seo_url": "https://www.guitarcenter.com/Fender/Player-II-Stratocaster-Rosewood-Fingerboard-Electric-Guitar-3-Color-Sunburst-1500000428057.gc",
"features": "Player II Stratocaster delivers iconic Fender tone...",
"image_id": "M11487000001000",
"variants": [
{
"price": 849.99,
"sku_id": "site51500000477962",
"seo_url": "https://www.guitarcenter.com/Fender/Player-II-Stratocaster-Electric-Guitar-Cactus-Gray-1500000477962.gc",
"image_id": "M11487000006000",
"condition": "New",
"list_price": 849.99,
"display_name": "Fender Player II Stratocaster Electric Guitar - Cactus Gray"
}
],
"condition": "New",
"image_url": "https://media.guitarcenter.com/is/image/MMGS7/M11487000001000",
"list_price": 849.99,
"product_id": "site51500000000382965",
"display_name": "Fender Player II Stratocaster Electric Guitar - 3-Color Sunburst",
"review_count": 10,
"review_rating": 10
}
],
"total_hits": 2413,
"total_pages": 805,
"hits_per_page": 3
},
"status": "success"
}
}About the Guitarcenter API
The Guitarcenter API on Parse exposes 2 endpoints for the publicly available data on guitarcenter.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.