{"openapi":"3.1.0","info":{"title":"Product API for Sigourney-murat-test-store","description":"Sigourney public product API for Sigourney-murat-test-store. Retrieve AI-ready JSON-LD product data.","version":"1.0.0","contact":{"name":"Sigourney","url":"https://sigourney-saas.com"}},"servers":[{"url":"https://sigourney-saas.com/api/v1","description":"Production API"}],"security":[{"BearerAuth":[]}],"paths":{"/products":{"get":{"operationId":"listProducts","summary":"List products with JSON-LD payloads","description":"Returns a paginated list of products with their full Schema.org JSON-LD representations. Supports text search, category filtering, availability filtering, and currency filtering.","parameters":[{"name":"q","in":"query","required":false,"description":"Full-text search query (trigram similarity on title and description)","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Filter by category code (e.g. footwear, electronics)","schema":{"type":"string"}},{"name":"availability","in":"query","required":false,"description":"Filter by Schema.org availability (InStock, OutOfStock, PreOrder, LimitedAvailability)","schema":{"type":"string","enum":["InStock","OutOfStock","PreOrder","LimitedAvailability"]}},{"name":"currency","in":"query","required":false,"description":"Filter by ISO 4217 currency code (e.g. USD, EUR)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Number of items to return (default 50, max 100)","schema":{"type":"integer","default":50,"maximum":100,"minimum":1}},{"name":"offset","in":"query","required":false,"description":"Number of items to skip for pagination","schema":{"type":"integer","default":0,"minimum":0}}],"responses":{"200":{"description":"Successful response with product list","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer","description":"Total number of matching products"},"limit":{"type":"integer"},"offset":{"type":"integer"},"items":{"type":"array","items":{"type":"object","description":"Schema.org Product JSON-LD object"}}}}}}},"401":{"description":"Missing or invalid API key"},"429":{"description":"Rate limit exceeded (60 requests/minute)"}}}},"/products/{id}":{"get":{"operationId":"getProduct","summary":"Get a single product by ID or SKU","parameters":[{"name":"id","in":"path","required":true,"description":"Product UUID or SKU","schema":{"type":"string"}}],"responses":{"200":{"description":"Product JSON-LD payload","content":{"application/json":{"schema":{"type":"object","description":"Schema.org Product JSON-LD object"}}}},"401":{"description":"Missing or invalid API key"},"404":{"description":"Product not found"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key obtained from the Sigourney dashboard. Pass as: Authorization: Bearer {api_key}"}}}}