{ "openapi": "3.0.1", "info": { "title": "Orphaned Oil & Gas Well Proximity Screener - Phase I ESA", "description": "Screen any US coordinate against 117,672 documented orphaned oil and gas wells. Returns count in radius, nearest-well distance and bearing, status, well type, positional accuracy and a Phase I ESA risk signal. Covers 27 states; a site outside coverage is reported as such, never as clear.", "version": "1.0", "x-build-id": "eb7oDqdqZ3bDUWFzg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malonestar~orphaned-well-proximity-screener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malonestar-orphaned-well-proximity-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~orphaned-well-proximity-screener/runs": { "post": { "operationId": "runs-sync-malonestar-orphaned-well-proximity-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~orphaned-well-proximity-screener/run-sync": { "post": { "operationId": "run-sync-malonestar-orphaned-well-proximity-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", "required": [ "assets" ], "properties": { "assets": { "title": "Sites to screen", "type": "array", "description": "One object per site: {\"lat\": 34.07, \"lon\": -118.29, \"label\": \"Los Angeles infill site\", \"radiusMiles\": 0.5}. lat/lon are WGS84 decimal degrees. label is free text used on every output row. radiusMiles is optional and overrides the run-level radius for that site only." }, "radiusMiles": { "title": "Search radius (miles)", "minimum": 1, "maximum": 25, "type": "integer", "description": "Run-level search radius in statute miles, used for any site that does not carry its own radiusMiles. Accepts 0.05 to 25; ASTM E1527 Phase I practice commonly uses 0.25, 0.5 or 1 mile. If omitted the actor uses 1 mile." }, "includeWellDetail": { "title": "Emit one row per well as well as the site summary", "type": "boolean", "description": "When true, each site's summary row is followed by one row per documented orphaned well inside the radius, nearest first, with full identifiers, status, type, positional accuracy and source notes. When false (the actor's behaviour if omitted) only the one summary row per site is emitted. Each row is a billable result, so leave this off for large-radius portfolio screens." }, "maxWellsPerAsset": { "title": "Max well rows per site", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Caps how many per-well detail rows are emitted for each site when includeWellDetail is on. Wells are always emitted nearest-first, so the cap keeps the closest ones. If omitted the actor uses 100." }, "maxAssets": { "title": "Max sites per run", "minimum": 1, "maximum": 500, "type": "integer", "description": "Safety cap on how many sites a single run will screen. Extra sites are skipped with a warning in the log. If omitted the actor uses 50." }, "resolveAssetState": { "title": "Resolve each site's state to test dataset coverage", "type": "boolean", "description": "The USGS dataset covers 27 states. When this is on (the actor's behaviour if omitted) each site's state is resolved via the FCC census-block API with Census TIGERweb as a fallback, so a zero-well answer inside a covered state is reported as a genuine clear while a site in an uncovered state is reported as out_of_dataset_coverage rather than as clear. Turn it off only to skip those two lookups." }, "skipDriftChecks": { "title": "Skip the live upstream integrity checks", "type": "boolean", "description": "Diagnostic only. The actor normally verifies the live layer before emitting anything: field set, national well count floor, state coverage, status vocabulary, two positive canaries, two negative controls and a true-circle fidelity test. Skipping them removes the guarantee that the answers came from an undegraded source." }, "simulateOutage": { "title": "Force a source failure (diagnostic)", "enum": [ "none", "wells", "state", "both" ], "type": "string", "description": "Permanent diagnostic seam used to prove the failure path without waiting for a real outage. 'wells' fails the orphaned-well layer, 'state' fails the state resolver, 'both' fails both, 'none' is the normal behaviour. With 'wells' or 'both' the run fails loudly and emits nothing." } } }, "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 } } } } } } } } } }