Ibanez APIibanez.com ↗
Access Ibanez USA bass guitar specs, series, models, dealers, news, and artists via API. 8 endpoints covering the full electric bass catalog.
What is the Ibanez API?
The Ibanez USA API gives developers access to 8 endpoints covering the complete electric bass catalog at ibanez.com, including series listings, per-model specs, dealer locations, news, and endorsed artists. The get_bass_guitar_detail endpoint returns granular fields like cf_data_scale_mm, cf_cm_neck_material, cf_data_fretboard, and pickup descriptions for individual models. Whether you're building a gear comparison tool or a dealer locator, the data maps directly to what Ibanez publishes on their US site.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/8b04622a-a8d4-409f-b06d-e88c9dc5c4d5/list_bass_series' \ -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 ibanez-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: Ibanez Bass API — browse series, search models, find dealers."""
from parse_apis.ibanez_bass_api import Ibanez, Guitar, GuitarNotFound
client = Ibanez()
# List all bass series and print the first few
for series in client.serieses.list(limit=5):
print(series.name, series.id)
# Drill into a constructible series to list its guitars
sr_prestige = client.series(id="sr_prestige")
guitar = sr_prestige.guitars.list(limit=1).first()
if guitar:
print(guitar.model_number, guitar.body_material, guitar.scale_mm)
# Search guitars across the entire catalog
for g in client.guitars.search(query="SR", limit=3):
print(g.model_number, g.fretboard, g.neck_pickup)
# Fetch full detail for one guitar via refresh
if guitar:
try:
detail = guitar.refresh()
print(detail.model_number, detail.hardware_color, detail.bridge)
except GuitarNotFound as exc:
print(f"Guitar not found: {exc}")
# Browse dealer areas
area = client.dealerareas.list(limit=1).first()
if area:
print(area.area, area.detail[0].name, area.detail[0].tel)
# Latest news
for item in client.newsitems.list(limit=3):
print(item.title, item.url)
print("exercised: serieses.list / series.guitars.list / guitars.search / guitar.refresh / dealerareas.list / newsitems.list")
List all electric bass guitar series available on the Ibanez USA website. Each series groups related bass models (e.g. SR Prestige, BTB Standard). Returns the full catalog of series with identifiers, display names, and descriptions. No pagination — the full list is returned in a single response.
No input parameters required.
{
"type": "object",
"fields": {
"series": "array of series objects"
},
"sample": {
"data": {
"series": [
{
"_key": "sr_prestige",
"cf_ps_id": "SR Prestige",
"cf_ps_desc_us": "There are three principles behind the Ibanez Prestige line: Precision, Performance, and Playability.",
"cf_ps_name_us": "SR Prestige",
"cf_ps_regions": [
"us",
"na",
"eu"
]
},
{
"_key": "sr_standard",
"cf_ps_id": "SR Standard",
"cf_ps_desc_us": "",
"cf_ps_name_us": "SR Standard",
"cf_ps_regions": [
"us",
"na",
"eu",
"as",
"jp",
"cn"
]
}
]
},
"status": "success"
}
}About the Ibanez API
Bass Catalog Endpoints
The API starts with list_bass_series, which returns an array of series objects — each with a _key identifier, a cf_ps_name_us display name, and a cf_ps_desc_us description. That _key feeds directly into list_bass_guitars_by_series, which accepts a series_id parameter (e.g., sr_prestige, icb_standard) and returns all models in that series with fields including body material, fretboard, and pickup configurations. If you want everything at once, list_bass_guitars aggregates products across all series and returns a total count alongside the full product array — though it runs slower by design.
Model Detail and Search
get_bass_guitar_detail takes a product_id in the form sr6605_00_01 or icb720fm_1p_01 — the identifier surfaced by list_bass_guitars_by_series — and returns the deepest level of spec data: scale length in mm (cf_data_scale_mm), neck wood (cf_cm_neck_material), neck and bridge pickup descriptions, body material, and US model number (cf_cm_us_model_no). The search_products endpoint accepts a free-text query (e.g., SR600, GSR, ICB) and matches against model numbers and product codes, returning total hit count and a full array of matching product objects.
Dealers, News, and Artists
get_dealers returns authorized US dealers organized by state, with each dealer record including name, address, tel, and site. get_news pulls the latest announcements from the Ibanez USA news page, returning each item's title and a full URL. get_artists lists Ibanez-endorsed bass artists from the electric basses category, with each entry carrying a name and a direct URL to the artist's detail page on ibanez.com.
The Ibanez API is a managed, monitored endpoint for ibanez.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ibanez.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 ibanez.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 bass guitar spec comparison tool using
cf_data_scale_mm,cf_cm_neck_material, and pickup fields fromget_bass_guitar_detail. - Populate a dealer locator map using state, address, and phone data from
get_dealers. - Display the latest Ibanez product announcements in a gear news feed using
get_newstitles and URLs. - Create a series browser that walks users from
list_bass_seriesthroughlist_bass_guitars_by_seriesto individual model specs. - Index the full Ibanez bass catalog for site search using
list_bass_guitarsandsearch_products. - Show endorsed artist profiles alongside their signature bass models by combining
get_artistsURLs with product searches. - Track new model additions over time by periodically polling
list_bass_guitarsand diffing thetotalfield.
| 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 Ibanez have an official public developer API?+
What does `get_bass_guitar_detail` return that the list endpoints do not?+
get_bass_guitar_detail returns the most granular spec fields: cf_data_scale_mm (scale length in millimeters), cf_cm_neck_material (neck wood), cf_data_fretboard, cf_data_neck_pickup, cf_data_bridge_pickup, and cf_data_body_material. The list endpoints like list_bass_guitars_by_series include a subset of these fields, but get_bass_guitar_detail is the authoritative source for per-model hardware specs.Does the API cover Ibanez electric guitars, acoustics, or other instrument categories beyond electric bass?+
Does `get_dealers` cover dealers outside the United States?+
Is there any filtering or pagination on `list_bass_guitars` when the catalog is large?+
list_bass_guitars returns all products across every series in a single response with a total count, but does not currently expose filter or pagination parameters. The endpoint is noted to be slower than the per-series call. For targeted retrieval, use list_bass_guitars_by_series with a specific series_id, or use search_products with a keyword query to narrow results.