{"openapi":"3.1.0","info":{"title":"Gunpla Catalog API","version":"1.0.0","description":"Public, read-only API for sourced Gunpla product metadata. No API key is required. This service is not affiliated with or endorsed by Bandai or Bandai Namco."},"servers":[{"url":"https://gunpla.izzisgym.com/v1"}],"tags":[{"name":"Products"},{"name":"Dataset"},{"name":"Media"}],"paths":{"/products":{"get":{"tags":["Products"],"summary":"Search published products","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":256}},{"name":"grade","in":"query","schema":{"type":"string"}},{"name":"scale","in":"query","schema":{"type":"string"}},{"name":"work","in":"query","schema":{"type":"string"}},{"name":"channel","in":"query","schema":{"$ref":"#/components/schemas/ReleaseChannel"}},{"name":"verification","in":"query","schema":{"$ref":"#/components/schemas/VerificationStatus"}},{"name":"year_from","in":"query","schema":{"type":"integer","minimum":1980,"maximum":2100}},{"name":"year_to","in":"query","schema":{"type":"integer","minimum":1980,"maximum":2100}},{"name":"has_image","in":"query","schema":{"type":"boolean"}},{"name":"sort","in":"query","schema":{"type":"string","enum":["relevance","name","released_asc","released_desc","updated_desc"],"default":"relevance"}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}}],"responses":{"200":{"description":"Search result","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSearchResponse"}}}},"400":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}},"/products/{idOrSlug}":{"get":{"tags":["Products"],"summary":"Get a published product","parameters":[{"name":"idOrSlug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product detail"},"404":{"$ref":"#/components/responses/Problem"}}}},"/products/by-identifier/{scheme}/{value}":{"get":{"tags":["Products"],"summary":"Resolve an exact product identifier","parameters":[{"name":"scheme","in":"path","required":true,"schema":{"$ref":"#/components/schemas/IdentifierScheme"}},{"name":"value","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Product detail"},"404":{"$ref":"#/components/responses/Problem"}}}},"/facets":{"get":{"tags":["Products"],"summary":"List search facets","responses":{"200":{"description":"Facet values"}}}},"/changes":{"get":{"tags":["Dataset"],"summary":"List changes after a dataset version","parameters":[{"name":"after_version","in":"query","required":true,"schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Incremental changes and tombstones"}}}},"/dataset":{"get":{"tags":["Dataset"],"summary":"Get the active dataset manifest","responses":{"200":{"description":"Dataset manifest"}}}},"/exports/latest":{"get":{"tags":["Dataset"],"summary":"Get the current versioned JSONL export","responses":{"200":{"description":"Export URL or JSONL download"},"429":{"$ref":"#/components/responses/Problem"}}}},"/media/{id}":{"get":{"tags":["Media"],"summary":"Serve approved catalog media or redirect to object storage","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Image bytes from catalog storage","content":{"image/jpeg":{"schema":{"type":"string","format":"binary"}},"image/png":{"schema":{"type":"string","format":"binary"}},"image/webp":{"schema":{"type":"string","format":"binary"}},"image/gif":{"schema":{"type":"string","format":"binary"}}}},"304":{"description":"Not modified for the supplied ETag"},"307":{"description":"Temporary redirect to object storage"},"404":{"$ref":"#/components/responses/Problem"},"429":{"$ref":"#/components/responses/Problem"}}}}},"components":{"responses":{"Problem":{"description":"RFC 9457 problem detail","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}},"schemas":{"IdentifierScheme":{"type":"string","enum":["bandai_item_no","jan","gtin13","upc","ean","model_designation","source_id"]},"ReleaseChannel":{"type":"string","enum":["unknown","retail","premium_bandai","gundam_base","event","promotion","bundle","collaboration"]},"VerificationStatus":{"type":"string","enum":["discovered","sourced","verified","disputed","excluded"]},"ProductSummary":{"type":"object","required":["id","slug","displayNameEn","kind","channels","verificationStatus","hasImage","hasSourceImage","sourceImageUrl"],"properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"displayNameEn":{"type":"string"},"nameJa":{"type":["string","null"]},"kind":{"type":"string"},"grade":{"type":["string","null"]},"scale":{"type":["string","null"]},"primaryWork":{"type":["string","null"]},"firstReleaseDate":{"type":["string","null"],"format":"date"},"channels":{"type":"array","items":{"$ref":"#/components/schemas/ReleaseChannel"}},"verificationStatus":{"$ref":"#/components/schemas/VerificationStatus"},"hasImage":{"type":"boolean"},"hasSourceImage":{"type":"boolean"},"sourceImageUrl":{"type":["string","null"],"format":"uri","description":"Direct image URL discovered on the authoritative source page; not hosted by this API."}}},"ProductSearchResponse":{"type":"object","required":["data","page","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ProductSummary"}},"page":{"type":"object","properties":{"nextCursor":{"type":["string","null"]}}},"meta":{"type":"object","required":["dataset_version"],"properties":{"dataset_version":{"type":"integer"}}}}},"Problem":{"type":"object","required":["type","title","status","detail"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}}}}}}