{
    "openapi": "3.1.0",
    "info": {
        "title": "Goldpeak Public Product Discovery Feeds",
        "version": "1.1.3",
        "description": "Read-only live WooCommerce catalogue feeds with category, brand, price and stock filters. No customer, account or order API is provided."
    },
    "servers": [
        {
            "url": "https://goldpeakfoods.com"
        }
    ],
    "paths": {
        "/goldpeak-ai-products.json": {
            "get": {
                "operationId": "listProducts",
                "summary": "Search and list live WooCommerce products",
                "parameters": [
                    {
                        "name": "search",
                        "in": "query",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "category",
                        "in": "query",
                        "description": "Exact product-category ID or slug, for example oppo.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "brand",
                        "in": "query",
                        "description": "Brand slug. Falls back to a matching product category where the store uses brand categories.",
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "stock_status",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "instock",
                                "outofstock",
                                "onbackorder"
                            ]
                        }
                    },
                    {
                        "name": "min_price",
                        "in": "query",
                        "schema": {
                            "type": "number",
                            "minimum": 0
                        }
                    },
                    {
                        "name": "max_price",
                        "in": "query",
                        "schema": {
                            "type": "number",
                            "minimum": 0
                        }
                    },
                    {
                        "name": "orderby",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "modified",
                                "date",
                                "title",
                                "price",
                                "price-desc"
                            ]
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "schema": {
                            "type": "string",
                            "enum": [
                                "asc",
                                "desc"
                            ]
                        }
                    },
                    {
                        "name": "page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1
                        }
                    },
                    {
                        "name": "per_page",
                        "in": "query",
                        "schema": {
                            "type": "integer",
                            "minimum": 1,
                            "maximum": 100
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Product collection"
                    }
                }
            }
        },
        "/goldpeak-ai-products/category/{category-slug}.json": {
            "get": {
                "operationId": "listCategoryProducts",
                "summary": "List products in one exact category",
                "parameters": [
                    {
                        "name": "category-slug",
                        "in": "path",
                        "required": true,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Category product collection"
                    }
                }
            }
        },
        "/goldpeak-ai-categories.json": {
            "get": {
                "operationId": "listCategories",
                "summary": "List product categories including hierarchy paths and category-specific feeds",
                "responses": {
                    "200": {
                        "description": "Categories"
                    }
                }
            }
        }
    }
}