{ "openapi": "3.0.1", "info": { "title": "NSW & Australian Council Planning Approvals & DA Tracker", "description": "Extracts NSW Development Application (DA) metadata from the official NSW Planning Portal Open Data API and enriches it with trade-lead classification.", "version": "0.1", "x-build-id": "AaPykYgWnvaGDXeJU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/roomy_stove~aus-council-da-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-roomy_stove-aus-council-da-tracker", "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/roomy_stove~aus-council-da-tracker/runs": { "post": { "operationId": "runs-sync-roomy_stove-aus-council-da-tracker", "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/roomy_stove~aus-council-da-tracker/run-sync": { "post": { "operationId": "run-sync-roomy_stove-aus-council-da-tracker", "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": [ "councilLga", "daysBack" ], "properties": { "councilLga": { "title": "Council LGA", "enum": [ "ALL", "Inner West Council", "City of Sydney", "Northern Beaches Council", "Parramatta City Council", "Blacktown City Council", "Sutherland Shire Council" ], "type": "string", "description": "Which NSW Local Government Area to track. Choose 'ALL' to scan every council in the lookback window.", "default": "Inner West Council" }, "daysBack": { "title": "Lookback Period (Days)", "minimum": 1, "maximum": 90, "type": "integer", "description": "How many days back from today to fetch lodged DAs.", "default": 7 }, "minCostAud": { "title": "Minimum Estimated Cost (AUD)", "minimum": 0, "type": "integer", "description": "Only return DAs with an estimated development cost at or above this value. DAs with no cost figure are excluded when this is greater than 0.", "default": 100000 }, "status": { "title": "Application Status", "enum": [ "Any", "Lodged", "Under Assessment", "Determined" ], "type": "string", "description": "Filter by application status. 'Any' returns all statuses.", "default": "Any" }, "tradeFocus": { "title": "Trade Focus", "enum": [ "Any", "Swimming Pool", "Demolition", "New Dwelling / Framing", "Subdivision / Civil", "Commercial", "Alterations & Additions" ], "type": "string", "description": "Only return DAs relevant to a specific trade, so you pay for leads you can actually act on. 'Any' returns everything.", "default": "Any" }, "enableLlmEnrichment": { "title": "Enable LLM Trade Classification", "type": "boolean", "description": "Optional, off by default. The NSW dataset is fully structured, so the deterministic rules classify it reliably without an LLM. Turn this on (and provide an OpenAI key) only if you want gpt-4o-mini to infer extra trade opportunities for development types the rules don't recognise. Falls back to rules-only if no key is provided.", "default": false }, "openaiApiKey": { "title": "OpenAI API Key", "type": "string", "description": "Optional. Required only for LLM enrichment. Can also be provided via the OPENAI_API_KEY environment variable. Without it, the actor uses the deterministic rules classifier." }, "maxResults": { "title": "Max Records Limit", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Hard cap on the number of billable dataset items returned per run. Protects against runaway costs.", "default": 100 } } }, "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 } } } } } } } } } }