{ "openapi": "3.0.1", "info": { "title": "Earthquake Data API - USGS Live Feed, Magnitude and Depth", "description": "For alerting bots, risk dashboards and hazard maps: worldwide earthquakes from the USGS's own API with magnitude, depth, tsunami flag, alert level and felt reports. Timestamps arrive as ISO, not Unix milliseconds, and latitude and longitude as named fields. US public domain, no API key.", "version": "0.1", "x-build-id": "SnAwIJapTOn9KTYfu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~earthquakes-usgs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-earthquakes-usgs", "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/neverempty~earthquakes-usgs/runs": { "post": { "operationId": "runs-sync-neverempty-earthquakes-usgs", "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/neverempty~earthquakes-usgs/run-sync": { "post": { "operationId": "run-sync-neverempty-earthquakes-usgs", "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": { "daysBack": { "title": "Days back from today", "minimum": 1, "maximum": 365, "type": "integer", "description": "How far back to look, when no explicit start date is given. Used together with the minimum magnitude.", "default": 7 }, "startTime": { "title": "Start date (YYYY-MM-DD)", "type": "string", "description": "Explicit start date. Overrides 'Days back'. Leave empty to use 'Days back'.", "default": "" }, "endTime": { "title": "End date (YYYY-MM-DD)", "type": "string", "description": "Explicit end date. Leave empty for 'up to now'.", "default": "" }, "minMagnitude": { "title": "Minimum magnitude", "minimum": 0, "maximum": 10, "type": "number", "description": "Only earthquakes at or above this magnitude. The default of 2.5 always returns results, because quakes of that size happen worldwide every day.", "default": 2.5 }, "latitude": { "title": "Center latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Optional. Only used together with Center longitude and Radius. All three must be set, or the area filter is ignored." }, "longitude": { "title": "Center longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Optional. Only used together with Center latitude and Radius." }, "radiusKm": { "title": "Radius in km", "minimum": 1, "maximum": 20000, "type": "number", "description": "Optional. Only earthquakes within this many kilometres of the centre point. Requires latitude and longitude." }, "limit": { "title": "Maximum results", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Upper bound on the number of earthquakes returned. USGS allows up to 20,000 per request.", "default": 1000 }, "orderBy": { "title": "Order", "enum": [ "time", "magnitude" ], "type": "string", "description": "Sort newest first, or strongest first.", "default": "time" }, "maxRetries": { "title": "Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry if USGS returns an error or something that is not JSON.", "default": 3 } } }, "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 } } } } } } } } } }