Adorama APIadorama.com ↗
Access Adorama's electric guitar catalog via API. Get product listings, pricing, stock status, variants, and highlights by SKU or brand filter.
What is the Adorama API?
The Adorama Electric Guitars API exposes 2 endpoints to retrieve electric guitar product data from Adorama's catalog, covering listings, pricing, stock status, and detailed variant information. The list_electric_guitars endpoint returns paginated summaries across brands like Fender, Ibanez, Jackson, and Schecter, while get_electric_guitar_detail delivers per-SKU data including color variants, feature highlights, and shipping information.
curl -X GET 'https://api.parse.bot/scraper/1819ce27-9fd2-4713-8fea-f923e0461978/list_electric_guitars?page=1&brand=Ibanez&sort_by=relevancy' \ -H 'X-API-Key: $PARSE_API_KEY'
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 adorama-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: Adorama Electric Guitars SDK — browse, filter, and inspect guitar products."""
from parse_apis.adorama_com_api import Adorama, SortBy, ProductNotFound
client = Adorama()
# List electric guitars sorted by price (low to high), capped at 5 results
for guitar in client.electric_guitar_summaries.list(sort_by=SortBy.PRICE_LOW, limit=5):
print(guitar.title, guitar.price, guitar.stock_status)
# Filter by brand and take the first result for drill-down
summary = client.electric_guitar_summaries.list(brand="Ibanez", limit=1).first()
if summary:
print(summary.title, summary.brand, summary.price)
# Navigate from summary to full detail via typed navigation
detail = summary.details()
print(detail.title, detail.stock_status, detail.is_discontinued)
for variant in detail.variants:
print(variant.sku, variant.price, variant.condition)
# Fetch a specific guitar by SKU directly
try:
guitar = client.electric_guitars.get(sku="FE0142811306")
print(guitar.title, guitar.brand, guitar.stock_status)
except ProductNotFound as exc:
print(f"Guitar not found: {exc.sku}")
print("exercised: electric_guitar_summaries.list / summary.details / electric_guitars.get")
List electric guitar products from Adorama's catalog. Results are auto-iterated across pages (24 items per page). Supports sorting by relevancy, price, newest, or rating, and filtering by brand. Returns product summaries including pricing, stock status, and highlights.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| brand | string | Filter results by brand name (e.g. Fender, Ibanez, Gretsch, Charvel, EVH, Jackson, Schecter, Washburn). Omitting returns all brands. |
| sort_by | string | Sort order for results. |
{
"type": "object",
"fields": {
"page": "integer",
"total": "integer",
"per_page": "integer",
"products": "array of electric guitar product summaries",
"total_pages": "integer"
},
"sample": {
"data": {
"page": 1,
"total": 234,
"per_page": 24,
"products": [
{
"mfr": null,
"sku": "IBAZ22S2MGR",
"brand": "Ibanez",
"price": 549.99,
"title": "Ibanez AZ Standard Series AZ22S2 Electric Guitar",
"rating": null,
"is_used": false,
"image_url": "https://www.adorama.com/images/product/ibanez-az-standard-az22s2-mint-green_ibaz22s2mgr.webp",
"high_price": 757.76,
"highlights": [
"Precision-crafted AZ Roasted Maple neck tone.",
"Versatile SSH pickup configuration for playability."
],
"product_url": "https://www.adorama.com/ibanez-az-standard-series-az22s2-electric-guitar/p/ibaz22s2mgr",
"is_pre_order": false,
"review_count": null,
"stock_status": "In",
"category_path": "Musical Instruments/Guitars/Electric Guitars",
"variant_count": 2,
"you_save_dollar": 207.77,
"you_save_percent": 27
}
],
"total_pages": 10
},
"status": "success"
}
}About the Adorama API
Listing and Filtering Electric Guitars
The list_electric_guitars endpoint returns paginated electric guitar product summaries from Adorama's catalog. Each page contains up to 24 items, and you can navigate pages using the page parameter. Results include fields like total, total_pages, and an array of products covering pricing, stock status, and highlights. Filter by a specific manufacturer using the brand parameter — accepted values include Fender, Ibanez, Gretsch, Charvel, EVH, Jackson, Schecter, and Washburn. Control result ordering with sort_by, which accepts relevancy, price, newest, or rating.
Retrieving Product Details by SKU
The get_electric_guitar_detail endpoint accepts a sku string (e.g. FE0142811306 or IBAZ22S2MGR) and returns a full product record. The response includes title, brand, image_url, product_url, main_category, category_id, and stock_status. The variants array breaks down each color or configuration option individually, each with its own pricing and stock status. The highlights array contains descriptive feature strings pulled directly from the product listing.
SKU Availability and Pagination
SKUs for use with get_electric_guitar_detail are available within the products array returned by list_electric_guitars. Pagination is 1-based — passing page=1 returns the first 24 results, page=2 the next, and so on up to total_pages. The total field tells you how many products match the current brand filter or default query, so you can calculate traversal depth before iterating.
The Adorama API is a managed, monitored endpoint for adorama.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when adorama.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official adorama.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a price comparison tool for electric guitars across brands like Fender, Gibson, and Ibanez using
list_electric_guitarswith thebrandfilter - Track stock availability changes over time by polling
get_electric_guitar_detailfor specific SKUs and monitoringstock_statusand variant-level availability - Populate a gear recommendation engine with product titles, highlights, and pricing from paginated
list_electric_guitarsresults - Sync Adorama's electric guitar inventory into an affiliate or price-alert platform using
total_pagesfor full catalog traversal - Display color and configuration options in a product UI using the
variantsarray fromget_electric_guitar_detail - Identify newly listed guitars by sorting
list_electric_guitarsresults withsort_by=newestand monitoring for unrecognized SKUs - Aggregate feature highlights across multiple SKUs to train or test a product attribute extraction model
| 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 | 100 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 Adorama have an official developer API?+
What does the `variants` field in `get_electric_guitar_detail` contain?+
variants array contains one object per color or configuration option for the product. Each variant carries its own pricing and stock status, so a single SKU can map to multiple purchasable options with different availability states.Does the API cover customer reviews or ratings for individual guitars?+
How does pagination work with `list_electric_guitars`?+
page parameter (1-based) to navigate, and check total_pages in the response to know how many pages exist for your current query or brand filter. The total field gives the full match count.