{ "openapi": "3.0.1", "info": { "title": "Earthquake & Wildfire Events API — USGS + NASA FIRMS", "description": "Returns earthquakes (USGS) and satellite fire detections (NASA FIRMS) for any area as flat rows, with watch mode for new and changed events; failed, unavailable and unchanged rows are never charged. Not affiliated with or endorsed by the USGS or NASA.", "version": "0.1", "x-build-id": "qEIWEEcloR1PlVGWI" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mouadapi~geospatial-event-intelligence/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mouadapi-geospatial-event-intelligence", "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/mouadapi~geospatial-event-intelligence/runs": { "post": { "operationId": "runs-sync-mouadapi-geospatial-event-intelligence", "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/mouadapi~geospatial-event-intelligence/run-sync": { "post": { "operationId": "run-sync-mouadapi-geospatial-event-intelligence", "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": { "areas": { "title": "Areas", "type": "array", "description": "Where to look, up to 20 areas. A box: \"west,south,east,north\" in degrees (for example \"-125,32,-114,42\" for California). A circle: \"latitude,longitude,radiusKm\" (for example \"34.05,-118.24,100\", up to 2,000 km). \"world\" for the whole globe. A name may come first (\"California: -125,32,-114,42\"). Objects work too: { \"name\", \"west\", \"south\", \"east\", \"north\" } or { \"name\", \"latitude\", \"longitude\", \"radiusKm\" }. A box that crosses the 180° meridian is given as two boxes.", "items": { "type": "string" } }, "eventTypes": { "title": "Event types", "type": "array", "description": "earthquake (USGS earthquake catalog) and fire (NASA FIRMS satellite fire detections). Fires need your NASA FIRMS key below.", "items": { "type": "string", "enum": [ "earthquake", "fire" ], "enumTitles": [ "Earthquakes (USGS)", "Fire detections (NASA FIRMS)" ] }, "default": [ "earthquake", "fire" ] }, "sinceDays": { "title": "Days", "minimum": 1, "maximum": 10, "type": "integer", "description": "The window in UTC days, today included (2 = today and yesterday). With a start date: that many days from it. FIRMS gives up to 5 days per request, so 6 to 10 days take two requests per area.", "default": 2 }, "dateFrom": { "title": "Start date (optional)", "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$", "type": "string", "description": "The first day of a past window (YYYY-MM-DD, UTC), for example 2026-09-29. Empty: the last days, today included." }, "minMagnitude": { "title": "Minimum earthquake magnitude", "minimum": -1, "maximum": 10, "type": "number", "description": "Smallest earthquake magnitude returned (USGS catalog magnitudes run from about -1 to 9.5).", "default": 2.5 }, "minFireConfidence": { "title": "Minimum fire confidence", "enum": [ "low", "nominal", "high" ], "type": "string", "description": "Smallest NASA FIRMS confidence class returned: low (every detection, more false alarms), nominal (FIRMS's usual choice) or high. MODIS's 0-100 % is read as low under 30, nominal 30-79 and high 80+.", "default": "nominal" }, "fireSources": { "title": "Fire products", "type": "array", "description": "The NASA FIRMS near-real-time products to read: VIIRS on NOAA-20 and NOAA-21 (375 m pixels) and MODIS on Terra and Aqua (1 km pixels). Each product's detections are separate rows.", "items": { "type": "string", "enum": [ "VIIRS_NOAA20_NRT", "VIIRS_NOAA21_NRT", "MODIS_NRT" ], "enumTitles": [ "VIIRS NOAA-20 (375 m)", "VIIRS NOAA-21 (375 m)", "MODIS Terra and Aqua (1 km)" ] }, "default": [ "VIIRS_NOAA20_NRT", "VIIRS_NOAA21_NRT" ] }, "firmsApiKey": { "title": "NASA FIRMS key (MAP_KEY)", "type": "string", "description": "Your own free NASA FIRMS MAP_KEY, sent to you by email when you ask for it at https://firms.modaps.eosdis.nasa.gov/api/map_key/ (5,000 requests per 10 minutes). Needed for fire detections; without it each area's fire part is one free failed row. Used only in requests to NASA FIRMS; never logged, stored or returned." }, "mode": { "title": "Mode", "enum": [ "watch", "export" ], "type": "string", "description": "Empty: watch when a watch list name is given, otherwise export. \"watch\" returns only events that are new or changed since the last run of the watch list; \"export\" returns every event. An explicit mode wins." }, "watchListName": { "title": "Watch list name", "type": "string", "description": "Name of your watch list (kept in your own storage between runs). Giving a name turns on watch mode. Watch mode without a name uses the list \"default\". Changing the areas or filters starts the list again (every event a baseline row)." }, "includeUnchanged": { "title": "Include unchanged events", "type": "boolean", "description": "Watch mode: also return events that did not change since the last run (free).", "default": false }, "maxItems": { "title": "Max charged events", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Most events returned and charged per run. Export: areas past the cap are not read. Watch: the rest come in the next run.", "default": 1000 } } }, "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 } } } } } } } } } }