{"openapi":"3.0.3","info":{"title":"NetzZone public catalogue","version":"1.0.0","description":"Read-only catalogue. The request host selects the store. Search\/product\/store share 120 requests\/minute per IP and store; feeds share a separate 10\/minute limit. Prices are EUR including VAT per storefront unit before cart adjustments. stock=999 denotes unlimited inventory. This API does not enable automatic AI indexing or expose checkout actions."},"servers":[{"url":"https:\/\/netzzone.com"}],"paths":{"\/api\/search\/products":{"get":{"operationId":"searchProducts","summary":"Search this store catalogue","parameters":[{"name":"q","in":"query","required":true,"description":"Product name query; multiple words required","schema":{"type":"string","minLength":2,"maxLength":100}},{"name":"language","in":"query","required":false,"description":"Requested language; translations fall back to English or German","schema":{"type":"string","enum":["en","de","fr","it","es"],"default":"en"}},{"name":"limit","in":"query","required":false,"description":"Results per page","schema":{"type":"integer","minimum":1,"maximum":50,"default":3}},{"name":"page","in":"query","required":false,"description":"Page number","schema":{"type":"integer","minimum":1,"maximum":100000,"default":1}},{"name":"brand","in":"query","required":false,"description":"Exact brand","schema":{"type":"string","maxLength":100}},{"name":"category","in":"query","required":false,"description":"Collection ID from \/api\/collections","schema":{"type":"integer","minimum":1}},{"name":"min_price_cents","in":"query","required":false,"description":"Inclusive bound on displayed EUR cents, including price rounding; maximum must not be below minimum","schema":{"type":"integer","minimum":0,"maximum":100000000}},{"name":"max_price_cents","in":"query","required":false,"description":"Inclusive bound on displayed EUR cents, including price rounding; maximum must not be below minimum","schema":{"type":"integer","minimum":0,"maximum":100000000}},{"name":"sort","in":"query","required":false,"description":"Order; product ID breaks ties","schema":{"type":"string","enum":["relevance","price_asc","price_desc","name_asc","name_desc"],"default":"relevance"}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"$ref":"#\/components\/schemas\/SearchResponse"}}}},"404":{"description":"Resource unavailable in this store"},"422":{"description":"Invalid query parameters; JSON when Accept is application\/json"},"429":{"description":"Rate limit exceeded; respect Retry-After"}}}},"\/api\/catalogue\/products\/{sku}":{"get":{"operationId":"getProduct","summary":"Retrieve public product specifications and variants","parameters":[{"name":"sku","in":"path","required":true,"description":"Stable SKU from search","schema":{"type":"string","format":"uuid"}},{"name":"language","in":"query","required":false,"description":"Requested language; translations fall back to English or German","schema":{"type":"string","enum":["en","de","fr","it","es"],"default":"en"}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"type":"object","properties":{"product":{"$ref":"#\/components\/schemas\/ProductDetails"},"computed_at":{"type":"string"}},"required":["product","computed_at"]}}}},"404":{"description":"Resource unavailable in this store"},"422":{"description":"Invalid query parameters; JSON when Accept is application\/json"},"429":{"description":"Rate limit exceeded; respect Retry-After"}}}},"\/api\/collections":{"get":{"operationId":"listCategories","summary":"Get category IDs for this store","parameters":[{"name":"language","in":"query","required":false,"description":"Requested language; translations fall back to English or German","schema":{"type":"string","enum":["en","de","fr","it","es"],"default":"en"}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"type":"object","properties":{"collections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"},"description":{"type":"string"},"url":{"type":"string"}}}},"language":{"type":"string"}},"required":["collections","language"]}}}},"404":{"description":"Resource unavailable in this store"},"422":{"description":"Invalid query parameters; JSON when Accept is application\/json"},"429":{"description":"Rate limit exceeded; respect Retry-After"}}}},"\/api\/catalogue\/store":{"get":{"operationId":"getStore","summary":"Seller, shipping countries, original localized policies and FAQ","parameters":[{"name":"language","in":"query","required":false,"description":"Requested language; translations fall back to English or German","schema":{"type":"string","enum":["en","de","fr","it","es"],"default":"en"}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"type":"object","required":["name","url","language","seller","policies","inventory","shipping_countries","shipping_policy","return_policy","terms","faq"],"additionalProperties":true}}}},"404":{"description":"Resource unavailable in this store"},"422":{"description":"Invalid query parameters; JSON when Accept is application\/json"},"429":{"description":"Rate limit exceeded; respect Retry-After"}}}},"\/api\/catalogue\/feed-status":{"get":{"operationId":"getFeedStatus","summary":"Count eligible and excluded records; 2 requests per minute per store and IP","parameters":[{"name":"language","in":"query","required":false,"description":"Requested language; translations fall back to English or German","schema":{"type":"string","enum":["en","de","fr","it","es"],"default":"en"}}],"responses":{"200":{"description":"Success","content":{"application\/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"language":{"type":"string"},"eligible":{"type":"integer"},"excluded":{"type":"integer"},"exclusion_reasons":{"type":"object","additionalProperties":{"type":"integer"}},"computed_at":{"type":"string"}},"required":["domain","language","eligible","excluded","exclusion_reasons","computed_at"]}}}},"404":{"description":"Resource unavailable in this store"},"422":{"description":"Invalid query parameters; JSON when Accept is application\/json"},"429":{"description":"Rate limit exceeded; respect Retry-After"}}}},"\/feeds\/google.xml":{"get":{"operationId":"getGoogleFeed","summary":"Complete Google Merchant Center RSS 2.0 snapshot","parameters":[{"name":"language","in":"query","required":false,"description":"Requested language; translations fall back to English or German","schema":{"type":"string","enum":["en","de","fr","it","es"],"default":"en"}}],"responses":{"200":{"description":"Success","content":{"application\/xml":{"schema":{"type":"string"}}}},"404":{"description":"Resource unavailable in this store"},"422":{"description":"Invalid query parameters; JSON when Accept is application\/json"},"429":{"description":"Rate limit exceeded; respect Retry-After"}}}},"\/feeds\/openai.jsonl":{"get":{"operationId":"getOpenAiFeed","summary":"Complete stable OpenAI discovery feed, one JSON object per line; onboarding requires approval","parameters":[{"name":"language","in":"query","required":false,"description":"Requested language; translations fall back to English or German","schema":{"type":"string","enum":["en","de","fr","it","es"],"default":"en"}}],"responses":{"200":{"description":"Success","content":{"application\/x-ndjson":{"schema":{"type":"string"}}}},"404":{"description":"Resource unavailable in this store"},"422":{"description":"Invalid query parameters; JSON when Accept is application\/json"},"429":{"description":"Rate limit exceeded; respect Retry-After"}}}}},"components":{"schemas":{"Product":{"type":"object","properties":{"id":{"type":"integer"},"sku":{"type":"string","format":"uuid"},"name":{"type":"string"},"slug":{"type":"string"},"brand":{"type":"string","nullable":true},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"images":{"type":"array","items":{"type":"string"}},"price":{"type":"number","description":"EUR major units; use price_cents for exact arithmetic"},"price_cents":{"type":"integer"},"original_price_cents":{"type":"integer"},"currency":{"type":"string","enum":["EUR"]},"includes_vat":{"type":"boolean"},"price_scope":{"type":"string","enum":["single_unit_storefront_before_cart_adjustments"]},"can_order":{"type":"boolean"},"stock":{"type":"integer","enum":[999],"description":"Unlimited inventory sentinel, not physical quantity or cart limit"},"inventory_policy":{"type":"string","enum":["unlimited"]},"availability":{"type":"string","enum":["in_stock"]},"is_active":{"type":"boolean"},"language":{"type":"string"},"product_updated_at":{"type":"string","format":"date-time","nullable":true}},"required":["id","sku","name","url","images","price_cents","currency","availability","stock","can_order"]},"ProductDetails":{"allOf":[{"$ref":"#\/components\/schemas\/Product"},{"type":"object","properties":{"specifications":{"type":"array","items":{"type":"object","additionalProperties":true}},"identifiers":{"type":"object","properties":{"gtin":{"type":"string"},"mpn":{"type":"string"}}},"alternate_urls":{"type":"object","additionalProperties":{"type":"string","format":"uri"}},"categories":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"url":{"type":"string"}}}},"policies":{"type":"object","additionalProperties":{"type":"string"}},"variants":{"type":"array","items":{"$ref":"#\/components\/schemas\/Product"}}},"required":["specifications","identifiers","alternate_urls","categories","policies","variants"]}]},"SearchResponse":{"type":"object","properties":{"query":{"type":"string"},"results":{"type":"array","items":{"$ref":"#\/components\/schemas\/Product"}},"count":{"type":"integer"},"total_count":{"type":"integer"},"has_more":{"type":"boolean"},"language":{"type":"string"},"page":{"type":"integer"},"limit":{"type":"integer"},"next_page_url":{"type":"string","format":"uri","nullable":true},"previous_page_url":{"type":"string","format":"uri","nullable":true},"computed_at":{"type":"string","format":"date-time"}},"required":["query","results","count","total_count","has_more","language","page","limit","next_page_url","previous_page_url","computed_at"]}}}}