Gunpla APIEvery kit · one API
Dataset v8Browse catalog

Public REST API · Dataset v8

The Gunpla catalog,
ready for anything.

Search kits, identifiers, releases, prices, and official images. Every published field stays connected to its source evidence.

Sourced & traceable

Every published field retains its evidence.

Developer first

Clean REST API with exact identifiers and powerful search.

Versioned data

Stable snapshots, incremental changes, and signed exports.

◇
1,974products
▥
3,944identifiers
▧
1,974images
API request exampleGET /v1/products?q=unicorn&limit=5
{
  "data": [{ "name": "Unicorn Gundam", "grade": "MG" }],
  "page": { "nextCursor": "…" },
  "meta": { "dataset_version": 8 }
}

Latest releases

View all releases →
Versioned datasetStable, predictable, and trackable.
Global coverageJapan releases and regional identifiers.
Official imagesSource links, checksums, and attribution.
Built for developersRESTful, fast, and easy to integrate.

Quick start

One request. No signup.

No token or SDK is required. Use the returned meta.dataset_version to identify the immutable snapshot.

  • 50 results per page; 200 maximum
  • Opaque cursor pagination
  • 300 requests per minute per client
  • RFC 9457 error responses
curl "https://gunpla.izzisgym.com/v1/products?q=RX-78-2&limit=5"

Exact identity

Identifiers win.

Exact product identifiers and mobile-suit designations rank before names, aliases, and fuzzy matches.

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-2

Try it live

API request console

OpenAPI 3.1 JSON ↗
Choose an endpoint and run a request.

Endpoints

MethodPathPurpose
GET/v1/products?q=rx-78&limit=5Search products
GET/v1/products?grade=HG&scale=1%2F144&has_image=true&limit=5Filter products
GET/v1/products/by-identifier/model_designation/RX-78-2Exact identifier lookup
GET/v1/facetsList facets
GET/v1/datasetDataset manifest
GET/v1/changes?after_version=0Incremental changes
GET/v1/exports/latestVersioned export
GET/v1/openapi.jsonOpenAPI contract
GET/healthService readiness

Image delivery

Use the media URL.

Product detail responses include a relative media[].url plus 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"
);
Independent catalog. This project is not affiliated with or endorsed by Bandai, Bandai Spirits, Bandai Namco, or Sunrise. Corrections and rights requests are available through the takedown page.