{
  "openapi": "3.0.1",
  "info": {
    "title": "Coles AU Product Search Scraper",
    "description": "Scrape Coles Australia product search results, prices, specials, categories, store context, barcode lookups, and normalized item data for grocery monitoring workflows.",
    "version": "0.0",
    "x-build-id": "LX30LMZ76qgoh827x"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dromb~coles-au-product-search-specials-stores-unofficial/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dromb-coles-au-product-search-specials-stores-unofficial",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/dromb~coles-au-product-search-specials-stores-unofficial/runs": {
      "post": {
        "operationId": "runs-sync-dromb-coles-au-product-search-specials-stores-unofficial",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/dromb~coles-au-product-search-specials-stores-unofficial/run-sync": {
      "post": {
        "operationId": "run-sync-dromb-coles-au-product-search-specials-stores-unofficial",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "operation"
        ],
        "properties": {
          "operation": {
            "title": "Operation",
            "enum": [
              "categories",
              "search",
              "search_filters",
              "item",
              "category",
              "specials",
              "specials_filters",
              "specials_catalogue",
              "item_by_barcode",
              "item_by_gtin",
              "store",
              "stores_by_postcode",
              "nearby_stores",
              "stores_search",
              "item_store_context",
              "availability_by_store"
            ],
            "type": "string",
            "description": "Choose a stable product, specials, category, or postcode-aware workflow. Barcode/GTIN reverse lookup and standalone store locator operations are experimental and may return no business result even when the run itself succeeds.",
            "default": "search"
          },
          "query": {
            "title": "Query",
            "type": "string",
            "description": "Required for `search` and `stores_search`. Optional for `search_filters` sample collection.",
            "default": "milk"
          },
          "page": {
            "title": "Native Coles page",
            "minimum": 1,
            "type": "integer",
            "description": "One-based native Coles page for `search`, `category`, `specials`, and `specials_catalogue`. Product counts per native page can vary.",
            "default": 1
          },
          "limit": {
            "title": "Optional result cap (not page size)",
            "minimum": 1,
            "type": "integer",
            "description": "For product listing operations (`search`, `category`, `specials`), this is an optional local maximum applied after the selected native Coles page is fetched. It does not change Coles upstream page size. Omit it to return the complete native page. For store-list operations it remains a maximum number of stores."
          },
          "details": {
            "title": "Enrich Details",
            "type": "boolean",
            "description": "Optional for `search`, `category`, `specials`, and `specials_catalogue`.",
            "default": false
          },
          "storeId": {
            "title": "Store ID",
            "type": "string",
            "description": "Optional store-aware context for product and specials operations."
          },
          "postcode": {
            "title": "Postcode",
            "type": "string",
            "description": "Optional postcode or required for `stores_by_postcode`."
          },
          "state": {
            "title": "State",
            "type": "string",
            "description": "Optional Australian state code for store-aware Coles operations."
          },
          "contextMode": {
            "title": "Context Mode",
            "type": "string",
            "description": "Optional store context mode. Default is `delivery`.",
            "default": "delivery"
          },
          "categoryId": {
            "title": "Category ID",
            "type": "string",
            "description": "Optional for `category`."
          },
          "categorySlug": {
            "title": "Category Slug",
            "type": "string",
            "description": "Optional for `category` or `specials_catalogue`."
          },
          "categoryUrl": {
            "title": "Category URL",
            "type": "string",
            "description": "Optional full category URL for `category`."
          },
          "itemId": {
            "title": "Item ID Alias",
            "type": "string",
            "description": "Optional for `item`, `item_store_context`, or `availability_by_store`."
          },
          "productId": {
            "title": "Product ID",
            "type": "string",
            "description": "Optional for Coles item operations."
          },
          "itemSlug": {
            "title": "Item Slug",
            "type": "string",
            "description": "Optional for item-oriented operations."
          },
          "slug": {
            "title": "Slug Alias",
            "type": "string",
            "description": "Optional slug alias for item or specials-catalogue operations."
          },
          "url": {
            "title": "URL",
            "type": "string",
            "description": "Optional full product/category/catalogue URL."
          },
          "special": {
            "title": "Special View",
            "type": "string",
            "description": "Optional for `specials`: `allspecials`, `halfprice`, `multibuy`, or `onlineonly`.",
            "default": "allspecials"
          },
          "barcode": {
            "title": "Barcode (Experimental)",
            "type": "string",
            "description": "Required for experimental `item_by_barcode`. Reverse lookup is not currently reliable; prefer `item` with a full Coles product URL."
          },
          "gtin": {
            "title": "GTIN (Experimental)",
            "type": "string",
            "description": "Required for experimental `item_by_gtin`. Reverse lookup is not currently reliable; prefer `item` with a full Coles product URL."
          },
          "radius": {
            "title": "Radius",
            "type": "integer",
            "description": "Optional for store search operations.",
            "default": 25
          },
          "lat": {
            "title": "Latitude (Experimental Store Locator)",
            "type": "number",
            "description": "Required for experimental `nearby_stores`. Standalone store discovery is currently best-effort; postcode-aware product context is more reliable."
          },
          "lon": {
            "title": "Longitude (Experimental Store Locator)",
            "type": "number",
            "description": "Required for experimental `nearby_stores`. Standalone store discovery is currently best-effort; postcode-aware product context is more reliable."
          },
          "refresh": {
            "title": "Refresh Categories",
            "type": "boolean",
            "description": "Optional for `categories`. Force live category refresh.",
            "default": false
          },
          "includeRaw": {
            "title": "Include Raw Payload",
            "type": "boolean",
            "description": "Optional for any operation. Include the unnormalized source payload in the OUTPUT summary.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}