{ "openapi": "3.0.1", "info": { "title": "Minnesota DNR Timber Sales", "description": "Minnesota state timber auction calendar (date, type, status, location, notice/results link) plus the DNR archive of sealed-bid tabulation records and notice-of-sale PDFs, as clean structured records.", "version": "1.0", "x-build-id": "wpB6AnNpmaVg20yII" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mdcurt~mn-dnr-timber-sales/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mdcurt-mn-dnr-timber-sales", "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/mdcurt~mn-dnr-timber-sales/runs": { "post": { "operationId": "runs-sync-mdcurt-mn-dnr-timber-sales", "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/mdcurt~mn-dnr-timber-sales/run-sync": { "post": { "operationId": "run-sync-mdcurt-mn-dnr-timber-sales", "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", "properties": { "includeCalendar": { "title": "Include auction calendar", "type": "boolean", "description": "Collect every upcoming and recently completed state timber auction from the DNR Timber Sales Calendar (date, auction type, notice status, sale name, time, location, link to the notice of sale or results when posted). One record per auction.", "default": true }, "includeDocuments": { "title": "Include archive documents", "type": "boolean", "description": "Also collect the Timber Auction Archive: links to sealed-bid auction tabulation records (who bought which tracts and at what price) and archived notice-of-sale PDFs, with the auction date, sale name and auction type parsed from each title. One record per document.", "default": false }, "documentTypes": { "title": "Document types", "type": "array", "description": "Which archive documents to include when 'Include archive documents' is on.", "items": { "type": "string", "enum": [ "Sealed Bid Tabulation Record", "Notice of Sale" ], "enumTitles": [ "Sealed-bid auction tabulation records (results)", "Notice-of-sale PDFs (tract listings)" ] }, "default": [ "Sealed Bid Tabulation Record", "Notice of Sale" ] }, "documentYears": { "title": "Document years to keep", "minimum": 0, "maximum": 20, "type": "integer", "description": "Keep only archive documents from the most recent N calendar years (counting the current year). 0 keeps the whole archive (about 800 documents going back to 2016).", "default": 2 }, "dateFrom": { "title": "Auctions from (YYYY-MM-DD)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep only calendar rows and documents dated on or after this day. Leave empty for no lower bound." }, "dateTo": { "title": "Auctions until (YYYY-MM-DD)", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Keep only calendar rows and documents dated on or before this day. Leave empty for no upper bound." }, "auctionTypes": { "title": "Auction types", "type": "array", "description": "Keep only these auction types. Regular auctions are open to all qualified purchasers; Intermediate auctions are reserved for purchasers with 30 or fewer employees; Special covers decorative-materials, salvage and Camp Ripley sales. Empty = all.", "items": { "type": "string", "enum": [ "Regular", "Intermediate", "Special" ], "enumTitles": [ "Regular", "Intermediate", "Special" ] }, "default": [] }, "statuses": { "title": "Notice statuses", "type": "array", "description": "Keep only calendar rows with these notice-of-sale statuses, e.g. Final (notice posted, tracts visible) or Completed (results posted). Empty = all statuses.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Maximum records", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Stop after this many records in total (calendar rows first, then documents). Each record is one paid dataset item.", "default": 200 } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }