{ "openapi": "3.0.1", "info": { "title": "USGS Seismic Design Screener - ASCE 7-22 & 7-16 SDC Lookup", "description": "Batch coordinates to ASCE 7 seismic design values from the keyless USGS service. Each row carries the edition you pick AND ASCE 7-22, the current standard: SDS, SD1, SDC, SS, S1, SMS, SM1, PGA_M, Fa, Fv, TL, design spectra, ASCE 41-17 retrofit levels. MCP-ready. Screening aid, not a stamped design.", "version": "1.1", "x-build-id": "GJZOeuh42dIA8CLeu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/malonestar~usgs-seismic-design-screener/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-malonestar-usgs-seismic-design-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~usgs-seismic-design-screener/runs": { "post": { "operationId": "runs-sync-malonestar-usgs-seismic-design-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~usgs-seismic-design-screener/run-sync": { "post": { "operationId": "run-sync-malonestar-usgs-seismic-design-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": "Coordinates to look up ASCE 7 seismic design parameters for. Each item is an object: {\"lat\": , \"lon\": , \"label\": \"\", \"riskCategory\": \"I|II|III|IV\" (optional per-site override), \"siteClass\": \"A|B|C|D|E\" (optional per-site override)}. Each site produces exactly one billable dataset row regardless of how many editions are queried for it. Invalid points produce an ERROR row and the run continues; if EVERY site fails upstream the run is failed so nothing is billed." }, "riskCategory": { "title": "Default risk category", "enum": [ "I", "II", "III", "IV" ], "type": "string", "description": "ASCE 7 Risk Category applied to any site that does not set its own riskCategory. I = low hazard to human life, II = ordinary buildings, III = substantial hazard, IV = essential facilities (hospitals, fire stations). Default II.", "default": "II" }, "siteClass": { "title": "Default site class", "enum": [ "A", "B", "C", "D", "E" ], "type": "string", "description": "ASCE 7 Site Class (soil profile) applied to any site that does not set its own siteClass. A = hard rock, B = rock, C = very dense soil/soft rock, D = stiff soil, E = soft clay soil. D is the code default when the soil is unknown. Default D.", "default": "D" }, "referenceDocument": { "title": "Reference standard", "enum": [ "asce7-16", "asce7-22", "asce7-10", "asce7-05", "asce41-17", "nehrp-2015", "nehrp-2020" ], "type": "string", "description": "Reference standard used for the ss/s1/sds/sd1/sdc columns. asce7-22 is the CURRENT edition (referenced by IBC 2024); asce7-16 remains the default so existing integrations keep the values they were built on, and an ASCE 7-22 cross-check is added to every row anyway in the asce722_* columns. asce7-10 and asce7-05 are for older permits; asce41-17 is seismic evaluation and retrofit of EXISTING buildings (BSE-2N/1N/2E/1E hazard levels, not SDS/SD1/SDC); nehrp-2015 and nehrp-2020 are the NEHRP provisions behind ASCE 7-16 and 7-22 respectively.", "default": "asce7-16" }, "maxAssets": { "title": "Max site lookups", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety cap on the number of sites looked up per run. Sites beyond this cap are skipped with a warning.", "default": 500 }, "includeCurrentEdition": { "title": "Add an ASCE 7-22 cross-check to every row", "type": "boolean", "description": "ON by default. Adds a second lookup against ASCE 7-22, the current edition, and puts the result in the asce722_* columns alongside whichever edition you selected - so you can see where the two disagree. This matters: ASCE 7-16 returns no SD1 and no Seismic Design Category for high-seismicity soft-soil sites (Sec. 11.4.8), while ASCE 7-22 resolves most of them outright. San Francisco Site Class D is SDC null under 7-16 and SDC D under 7-22. Does NOT change your billing - still one row per site. Skipped automatically when the selected edition already is ASCE 7-22, or is ASCE 41-17.", "default": true }, "includeSpectra": { "title": "Include design and MCE_R response spectra", "type": "boolean", "description": "ON by default. Emits the full design and MCE_R response-spectrum period/ordinate arrays that the USGS service already returns - the curve you plot for a response-spectrum analysis. Turn off for a narrower CSV export.", "default": true }, "verifyUpstream": { "title": "Verify the USGS service before screening (recommended)", "type": "boolean", "description": "ON by default. Before any of your sites are screened, the run probes three known-good canary points (San Francisco and Chicago under ASCE 7-16, San Francisco under ASCE 7-22) and fails the whole run if the design values, the payload shape, or the edition echoed back have drifted. Costs three extra requests and protects you from being billed for values computed off a silently changed hazard model. Turn off only if you need the absolute lowest latency.", "default": true } } }, "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 } } } } } } } } } }