Public REST API · v1 · No API key required
Gunpla data,
ready to build with.
Search official Bandai and Bandai Spirits Gunpla releases by name, grade, scale, product number, JAN, UPC, mobile-suit designation, release channel, and more.
Quick start
Your first request
No signup, token, or SDK is required. Send a GET request and use the returned meta.dataset_version to identify the immutable catalog snapshot.
- 50 results per page by default; 200 maximum
- Opaque, version-stable cursor pagination
- 300 requests per minute per client
- RFC 9457 problem responses
curl "https://gunpla.izzisgym.com/v1/products?q=RX-78-2&limit=5"const response = await fetch(
"https://gunpla.izzisgym.com/v1/products?q=RX-78-2&limit=5"
);
const { data, page, meta } = await response.json();Search order
Identifiers win
Ranking favors exact product identifiers and model designations before exact names, aliases, and fuzzy matches. For deterministic integrations, use the exact identifier endpoint.
GET /v1/products/by-identifier/bandai_item_no/1008658
GET /v1/products/by-identifier/jan/4573102603869
GET /v1/products/by-identifier/model_designation/RX-78-2Try it live
API request console
Choose an endpoint and run a request.
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/products?q=rx-78&limit=5 | Search products |
| GET | /v1/products/by-identifier/model_designation/RX-78-2 | Exact identifier lookup |
| GET | /v1/facets | List facets |
| GET | /v1/dataset | Dataset manifest |
| GET | /v1/changes?after_version=0 | Incremental changes |
Images
Use the media URL
Product detail responses include a relative media[].url. Prefix it with this domain. Each asset includes its MIME type, byte size, SHA-256 checksum, attribution, source page, and availability state.
const imageUrl = new URL(
product.media[0].url,
"https://gunpla.izzisgym.com"
);