# Liquorland AU Catalog & Product Lookup (Unofficial) (`dromb/liquorland-au-catalog-product-lookup-unofficial`) Actor Fetch Liquorland Australia categories, category listings, and product details in normalized output. - **URL**: https://apify.com/dromb/liquorland-au-catalog-product-lookup-unofficial.md - **Developed by:** [Dmitriy Gyrbu](https://apify.com/dromb) (community) - **Categories:** E-commerce, Automation - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $0.04 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Liquorland AU Search, Catalog & Store Tools (Unofficial) Search Liquorland Australia products, inspect the full navigation tree, enrich product cards with Bazaarvoice review data, and resolve store/location context in normalized output. This is an unofficial actor and is not affiliated with Liquorland. ### Supported operations - `categories` - `category` - `item` - `search` - `search_suggest` - `locations` - `suburbs` - `nearby_stores` ### Operation guide The Apify Console form shows the union of all supported fields, so the visible inputs do not change when you switch `operation`. Use the guide below to know which fields are required. - `categories` Required: none Optional: `state`, `includeRaw` - `category` Required: `path` or `categoryPath` or `categoryId` Optional: `state`, `page`, `facets`, `sort`, `show`, `includeRaw` - `item` Required: `url`, or `productId` plus `itemSlug` Optional: `state`, `includeReviews`, `reviewLimit`, `includeRaw` - `search` Required: `query` Optional: `state`, `storeId`, `page`, `facets`, `sort`, `show`, `fallbackToSuggest`, `v`, `userId`, `clientId`, `includeRaw` - `search_suggest` Required: `query` Optional: `state`, `v`, `includeRaw` - `locations` Required: `query` or `postcode` Optional: `includeRaw` - `suburbs` Required: `query` or `postcode` Optional: `includeRaw` - `nearby_stores` Required: `lat`, `lon` Optional: `page`, `size`, `userId`, `authToken`, `userKey`, `includeRaw` Note: advanced operation. It depends on a live anonymous Liquorland session exposing both `userId` and `authToken`, or on you supplying those values explicitly. ### Validated starter examples These are the safest first-run inputs I validated locally against the live site. They are the examples I recommend for private smoke checks and Apify Store saved tasks. ### How categories work `categories` is built from Liquorland's state-specific navigation endpoint `/api/navigation/ll/{state}` and preserves much more of the source tree than a flat "category URL" list. Each row includes: - `kind` One of `category`, `landing_page`, `facet`, `group`, or `group_item` - `category_supported` `true` only when the row can be used directly with the `category` operation - `has_url` Whether the row has a real URL/path - `facet_only` `true` for filter-only rows from the navigation tree That means `/specials/*` rows are still returned, but they are marked as `kind=landing_page` and `category_supported=false`, so users can see them without mistaking them for real API categories. For the best UX: - use `categories` first to inspect the state-specific tree - use rows with `category_supported=true` for `category` - keep `/specials/*` rows for merchandising insight, but not as `category` inputs ### Example inputs ```json { "operation": "categories", "state": "nsw", "includeRaw": false } ```` ```json { "operation": "category", "path": "/beer", "state": "nsw", "page": 1, "facets": "", "sort": "", "show": 72, "includeRaw": false } ``` ```json { "operation": "item", "productId": "7705729", "itemSlug": "lorry-boys-low-carb-lager-can-375ml", "url": "https://www.liquorland.com.au/beer-and-cider/lorry-boys-low-carb-lager-can-375ml_7705729?uom=CTN24", "state": "nsw", "includeReviews": true, "reviewLimit": 3, "includeRaw": false } ``` ```json { "operation": "search", "query": "vodka", "state": "vic", "storeId": "2278", "page": 1, "facets": "", "sort": "", "show": 60, "fallbackToSuggest": true, "v": 2, "includeRaw": false } ``` ```json { "operation": "search_suggest", "query": "wil", "state": "vic", "v": 2, "includeRaw": false } ``` ```json { "operation": "locations", "query": "3000", "includeRaw": false } ``` ```json { "operation": "suburbs", "query": "3000", "includeRaw": false } ``` ### Advanced nearby stores example `nearby_stores` is useful, but it is not a reliable first smoke because Liquorland does not always expose the anonymous session token needed for that inventory endpoint. Use it after validating the actor with the starter examples above. ```json { "operation": "nearby_stores", "lat": -37.8133386, "lon": 144.9708234, "page": 1, "size": 10, "includeRaw": false } ``` ### Output - Dataset: normalized products or structured navigation/location/store rows - Key-value store `OUTPUT`: run summary with `source`, `operation`, `success`, `total`, `errors`, `proxy`, and `monetization` ### Notes - `search` now tries the product-search API first even without `storeId`, but store-aware runs are still best when you provide a real `storeId`. - A practical way to get `storeId` is `locations` or `nearby_stores`. - If Liquorland blocks the full search API, the actor can degrade gracefully to `search_suggest` so the run still returns useful product candidates. - `item` supports URL-driven fallback recovery and can optionally enrich products with Bazaarvoice review stats and a small recent-review sample. - `locations` and `suburbs` map to the public suburb search endpoint and are aliases of the same capability. - `nearby_stores` uses the authenticated inventory endpoint and returns richer store metadata when the anonymous session bootstrap succeeds or when you provide `userId` plus `authToken` explicitly. - If `nearby_stores` cannot bootstrap those credentials, the actor returns a structured `unsupported` payload with a hint instead of a raw failure. - Default proxy strategy is `direct`. - The runtime is prepared for future pay-per-event monetization. # Actor input Schema ## `operation` (type: `string`): Actor operation to execute. The Console form shows all possible fields at once, but the generated default input intentionally stays minimal: only `operation` is prefilled. Check the README for the exact required inputs and validated starter examples for each operation. ## `state` (type: `string`): Optional for categories, category, item, search, and search\_suggest. Australian state code such as `nsw` or `vic`. Defaults to `nsw` when omitted. ## `query` (type: `string`): Required for search, search\_suggest, locations, and suburbs. Use product keywords or a postcode/suburb lookup. ## `postcode` (type: `string`): Optional alias for locations/suburbs. Equivalent to `query`. ## `page` (type: `integer`): Optional for category, search, and nearby\_stores. One-based page index. Defaults to `1` when omitted. ## `size` (type: `integer`): Optional for nearby\_stores. Number of stores per page. Defaults to `10` when omitted. ## `show` (type: `integer`): Optional for category and search. Number of products per page. Category runs often use `72`, search runs often use `60`. ## `sort` (type: `string`): Optional for category and search. Pass the site sort key when needed. ## `facets` (type: `string`): Optional for category and search. Facet string copied from Liquorland navigation/search output when needed. ## `storeId` (type: `string`): Optional for search. Enables richer store-aware search. A practical real value looks like `2278`, obtainable from locations/nearby\_stores. ## `userId` (type: `string`): Optional advanced field for search or nearby\_stores. Usually auto-detected from the session token. ## `clientId` (type: `string`): Optional advanced field for search. Usually auto-detected from the `_ga` cookie. ## `authToken` (type: `string`): Optional advanced field for nearby\_stores. Supply it together with `userId` if Liquorland does not expose an anonymous session token automatically. ## `userKey` (type: `string`): Optional advanced field for nearby\_stores. A random UUID is generated automatically when omitted. ## `fallbackToSuggest` (type: `boolean`): Optional for search. When enabled, blocked or unavailable product search falls back to search suggestions instead of failing hard. Defaults to `true` when omitted. ## `v` (type: `integer`): Optional for search and search\_suggest. Defaults to `2` when omitted. ## `categoryId` (type: `string`): Optional for `category`. Use `path`, `categoryPath`, or `categoryId`. ## `categoryPath` (type: `string`): Optional for `category`. Use `categoryPath`, `path`, or `categoryId`. ## `path` (type: `string`): Optional for `category`. Category path such as `/beer`. ## `itemId` (type: `string`): Optional for `item`. Use `itemId`, `productId`, or `url`. ## `productId` (type: `string`): Optional for `item`. Use `productId`, `itemId`, or `url`. ## `itemSlug` (type: `string`): Optional for `item`. Use together with `productId`, or supply `url`. ## `slug` (type: `string`): Optional for `item`. Alias for `itemSlug`. ## `url` (type: `string`): Optional for `item`. Full product URL alternative to `productId` plus `itemSlug`. ## `includeReviews` (type: `boolean`): Optional for `item`. Fetch Bazaarvoice review summary and recent reviews when available. Defaults to `false` when omitted. ## `reviewLimit` (type: `integer`): Optional for `item`. Number of recent reviews to request when `includeReviews` is enabled. Defaults to `3` when omitted. ## `lat` (type: `number`): Required for nearby\_stores. Treat nearby\_stores as an advanced operation: it may also need `authToken` and `userId` if anonymous session bootstrap is unavailable. ## `lon` (type: `number`): Required for nearby\_stores. Treat nearby\_stores as an advanced operation: it may also need `authToken` and `userId` if anonymous session bootstrap is unavailable. ## `includeRaw` (type: `boolean`): Optional for any operation. Include the unnormalized source payload in the OUTPUT summary. ## Actor input object example ```json { "operation": "categories" } ``` # Actor output Schema ## `results` (type: `string`): Normalized dataset items returned by the actor. ## `summary` (type: `string`): Run summary JSON stored under the OUTPUT key. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("dromb/liquorland-au-catalog-product-lookup-unofficial").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("dromb/liquorland-au-catalog-product-lookup-unofficial").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call dromb/liquorland-au-catalog-product-lookup-unofficial --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dromb/liquorland-au-catalog-product-lookup-unofficial", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Liquorland AU Catalog & Product Lookup (Unofficial)", "description": "Fetch Liquorland Australia categories, category listings, and product details in normalized output.", "version": "0.0", "x-build-id": "qSJwHD3yjn3bUcdmR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dromb~liquorland-au-catalog-product-lookup-unofficial/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dromb-liquorland-au-catalog-product-lookup-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~liquorland-au-catalog-product-lookup-unofficial/runs": { "post": { "operationId": "runs-sync-dromb-liquorland-au-catalog-product-lookup-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~liquorland-au-catalog-product-lookup-unofficial/run-sync": { "post": { "operationId": "run-sync-dromb-liquorland-au-catalog-product-lookup-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", "category", "item", "search", "search_suggest", "locations", "suburbs", "nearby_stores" ], "type": "string", "description": "Actor operation to execute. The Console form shows all possible fields at once, but the generated default input intentionally stays minimal: only `operation` is prefilled. Check the README for the exact required inputs and validated starter examples for each operation.", "default": "categories" }, "state": { "title": "State", "type": "string", "description": "Optional for categories, category, item, search, and search_suggest. Australian state code such as `nsw` or `vic`. Defaults to `nsw` when omitted." }, "query": { "title": "Query", "type": "string", "description": "Required for search, search_suggest, locations, and suburbs. Use product keywords or a postcode/suburb lookup." }, "postcode": { "title": "Postcode Alias", "type": "string", "description": "Optional alias for locations/suburbs. Equivalent to `query`." }, "page": { "title": "Page", "type": "integer", "description": "Optional for category, search, and nearby_stores. One-based page index. Defaults to `1` when omitted." }, "size": { "title": "Nearby Page Size", "type": "integer", "description": "Optional for nearby_stores. Number of stores per page. Defaults to `10` when omitted." }, "show": { "title": "Search/Category Page Size", "type": "integer", "description": "Optional for category and search. Number of products per page. Category runs often use `72`, search runs often use `60`." }, "sort": { "title": "Sort", "type": "string", "description": "Optional for category and search. Pass the site sort key when needed." }, "facets": { "title": "Facets", "type": "string", "description": "Optional for category and search. Facet string copied from Liquorland navigation/search output when needed." }, "storeId": { "title": "Store ID", "type": "string", "description": "Optional for search. Enables richer store-aware search. A practical real value looks like `2278`, obtainable from locations/nearby_stores." }, "userId": { "title": "User ID", "type": "string", "description": "Optional advanced field for search or nearby_stores. Usually auto-detected from the session token." }, "clientId": { "title": "Client ID", "type": "string", "description": "Optional advanced field for search. Usually auto-detected from the `_ga` cookie." }, "authToken": { "title": "Auth Token", "type": "string", "description": "Optional advanced field for nearby_stores. Supply it together with `userId` if Liquorland does not expose an anonymous session token automatically." }, "userKey": { "title": "User Key", "type": "string", "description": "Optional advanced field for nearby_stores. A random UUID is generated automatically when omitted." }, "fallbackToSuggest": { "title": "Fallback To Search Suggest", "type": "boolean", "description": "Optional for search. When enabled, blocked or unavailable product search falls back to search suggestions instead of failing hard. Defaults to `true` when omitted." }, "v": { "title": "Search API Version", "type": "integer", "description": "Optional for search and search_suggest. Defaults to `2` when omitted." }, "categoryId": { "title": "Category Path Alias", "type": "string", "description": "Optional for `category`. Use `path`, `categoryPath`, or `categoryId`." }, "categoryPath": { "title": "Category Path", "type": "string", "description": "Optional for `category`. Use `categoryPath`, `path`, or `categoryId`." }, "path": { "title": "Path", "type": "string", "description": "Optional for `category`. Category path such as `/beer`." }, "itemId": { "title": "Product ID Alias", "type": "string", "description": "Optional for `item`. Use `itemId`, `productId`, or `url`." }, "productId": { "title": "Product ID", "type": "string", "description": "Optional for `item`. Use `productId`, `itemId`, or `url`." }, "itemSlug": { "title": "Item Slug", "type": "string", "description": "Optional for `item`. Use together with `productId`, or supply `url`." }, "slug": { "title": "Slug Alias", "type": "string", "description": "Optional for `item`. Alias for `itemSlug`." }, "url": { "title": "Product URL", "type": "string", "description": "Optional for `item`. Full product URL alternative to `productId` plus `itemSlug`." }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Optional for `item`. Fetch Bazaarvoice review summary and recent reviews when available. Defaults to `false` when omitted." }, "reviewLimit": { "title": "Review Limit", "type": "integer", "description": "Optional for `item`. Number of recent reviews to request when `includeReviews` is enabled. Defaults to `3` when omitted." }, "lat": { "title": "Latitude", "type": "number", "description": "Required for nearby_stores. Treat nearby_stores as an advanced operation: it may also need `authToken` and `userId` if anonymous session bootstrap is unavailable." }, "lon": { "title": "Longitude", "type": "number", "description": "Required for nearby_stores. Treat nearby_stores as an advanced operation: it may also need `authToken` and `userId` if anonymous session bootstrap is unavailable." }, "includeRaw": { "title": "Include Raw Payload", "type": "boolean", "description": "Optional for any operation. Include the unnormalized source payload in the OUTPUT summary." } } }, "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 } } } } } } } } } } ```