{ "openapi": "3.0.1", "info": { "title": "USGS Karst Sinkhole Risk Screener — Geohazard by Coordinate", "description": "Karst & sinkhole-risk screener: batch point-in-polygon over the USGS national CONUS_Karst compilation (7 layers: carbonate, evaporite, sandstone karst + pseudokarst). Returns in_karst_terrain, karst type, near-surface vs buried, rock unit, and an editorial sinkhole-risk tier per coordinate.", "version": "1.1", "x-build-id": "oD7CLlfjk7J71dDHw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malonestar~karst-sinkhole-risk-screener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malonestar-karst-sinkhole-risk-screener", "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/malonestar~karst-sinkhole-risk-screener/runs": { "post": { "operationId": "runs-sync-malonestar-karst-sinkhole-risk-screener", "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/malonestar~karst-sinkhole-risk-screener/run-sync": { "post": { "operationId": "run-sync-malonestar-karst-sinkhole-risk-screener", "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": { "assets": { "title": "Assets (coordinates to screen)", "type": "array", "description": "List of sites to screen for karst/pseudokarst susceptibility. Each item is an object with numeric lat and lon (WGS84 decimal degrees) and an optional label. One billable result row is returned per asset, even when the site is clear. If a karst layer cannot be reached, that asset's karst fields come back null (not checked) rather than false, and the run fails outright if no asset could be answered.", "default": [ { "lat": 28.54, "lon": -81.38, "label": "Orlando, FL (buried carbonate karst, cover-collapse)" }, { "lat": 37.1869, "lon": -86.1005, "label": "Mammoth Cave, KY (exposed carbonate karst)" }, { "lat": 32.1751, "lon": -104.4437, "label": "Carlsbad, NM (exposed evaporite karst)" }, { "lat": 39.7392, "lon": -104.9903, "label": "Denver, CO (broad gypsum/evaporite extent only)" }, { "lat": 45.5152, "lon": -122.6784, "label": "Portland, OR (clear point, lava-tube pseudokarst nearby)" }, { "lat": 46.8772, "lon": -96.7898, "label": "Fargo, ND (verified clear on all 7 layers)" } ] }, "radiusMiles": { "title": "Nearby-karst search radius (miles)", "minimum": 0.1, "maximum": 25, "type": "number", "description": "For sites where the exact coordinate is clear, how far (miles) to search for mapped karst terrain nearby (flags near-boundary situations). The actor then halves the radius repeatedly to report nearest_karst_bound_miles, an honest upper bound on the distance. Clamped to 0.1-25 miles. Not used when the coordinate itself is already inside a mapped karst layer.", "default": 2 }, "maxAssets": { "title": "Max assets", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety cap on how many assets to screen in one run.", "default": 500 } } }, "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 } } } } } } } } } }