# USGS Volcanic Activity Tracker - Free Volcano Monitoring API (`ntriqpro/usgs-volcanic-activity-tracker`) Actor Free API for USGS volcano monitoring and eruption alerts. No subscription. Track active volcanoes, alert levels, locations, recent activity. Government data, pay-per-use. - **URL**: https://apify.com/ntriqpro/usgs-volcanic-activity-tracker.md - **Developed by:** [daehwan kim](https://apify.com/ntriqpro) (community) - **Categories:** AI, Business - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing $100.00 / 1,000 charged when analysis is successfully completeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## USGS Volcanic Activity Tracker - Free Volcano Monitoring API Free API for USGS volcano monitoring and eruption alerts. No subscription required. Track active volcanoes, alert levels, locations, recent activity. Government data, pay-per-use. ### Features - **Global Volcano Monitoring** — Real-time volcanic activity from USGS Volcano Disaster Assistance Program (VDAP) - **Alert Level Filtering** — Get volcanoes by alert level (NORMAL, ADVISORY, WARNING, CRITICAL) - **Country-Specific Tracking** — Filter by country (US, Ecuador, Philippines, Indonesia, etc.) - **Real-Time Updates** — Data updated daily from USGS monitoring networks - **Location Data** — Latitude, longitude, elevation for all tracked volcanoes - **Multi-Country Coverage** — Monitor volcanoes globally from 80+ countries - **No Setup Required** — Zero authentication needed, instant access to USGS data ### Data Sources - **USGS Volcano API** — https://volcanoes.usgs.gov/vsc/api/volcanoApi/ (Public Domain) - 1,300+ active and monitored volcanoes - Real-time alert levels - Updated daily by USGS scientists - Data from USGS Volcano Disaster Assistance Program (VDAP) The USGS Volcano Science Center monitors volcanoes globally and shares data via public API. ### Input | Field | Type | Description | Default | |-------|------|-------------|---------| | country | string | Filter by country (e.g., "United States", "Indonesia", "Japan") | "US" | | alertLevel | string | Filter by alert level ("NORMAL", "ADVISORY", "WARNING", "CRITICAL") | null | | limit | number | Max results to return | 10 | #### Alert Levels Explained | Level | Description | Action | |-------|-------------|--------| | **NORMAL** | Volcano quiet, background or below-background seismicity | Monitor routinely | | **ADVISORY** | Volcano showing elevated unrest; small possibility of eruption | Prepare contingency plans | | **WARNING** | Volcano erupting or imminent eruption; hazardous conditions likely | Activate emergency response | | **CRITICAL** | Hazardous eruption in progress or imminent; ashfall possible | Immediate evacuations | #### Example Inputs **Monitor US volcanoes only:** ```json { "country": "United States", "limit": 20 } ```` **Get critical volcanoes globally:** ```json { "country": "United States", "alertLevel": "CRITICAL", "limit": 100 } ``` **Monitor Indonesian volcanoes:** ```json { "country": "Indonesia", "limit": 50 } ``` ### Output The actor pushes results to the default dataset. Each entry contains: | Field | Type | Description | |-------|------|-------------| | volcanoName | string | Official volcano name (USGS nomenclature) | | country | string | Country where volcano is located | | latitude | number | Geographic latitude (WGS84) | | longitude | number | Geographic longitude (WGS84) | | elevation | number | Summit elevation in meters | | alertLevel | string | Current alert level (NORMAL, ADVISORY, WARNING, CRITICAL) | | lastUpdate | string | ISO 8601 timestamp of last USGS update | #### Example Output ```json [ { "volcanoName": "Mount Rainier", "country": "United States", "latitude": 46.8523, "longitude": -121.7603, "elevation": 4392, "alertLevel": "NORMAL", "lastUpdate": "2024-01-15T12:00:00Z" }, { "volcanoName": "Mount St. Helens", "country": "United States", "latitude": 46.2019, "longitude": -122.1813, "elevation": 2549, "alertLevel": "NORMAL", "lastUpdate": "2024-01-15T12:00:00Z" } ] ``` ### Usage #### JavaScript / Node.js Example ```javascript const Apify = require('apify'); // Monitor US volcanoes with WARNING or higher const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { country: 'United States', alertLevel: 'WARNING', limit: 20 }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); items.forEach(volcano => { console.log(`${volcano.volcanoName}: ${volcano.alertLevel}`); console.log(` Coordinates: ${volcano.latitude}, ${volcano.longitude}`); console.log(` Elevation: ${volcano.elevation}m`); console.log(` Last update: ${volcano.lastUpdate}\n`); }); ``` #### Get Critical Volcanoes Globally ```javascript const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { alertLevel: 'CRITICAL', limit: 50 }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); if (items.length > 0) { console.log(`CRITICAL volcanoes detected globally:`); items.forEach(v => { console.log(` ${v.volcanoName} (${v.country})`); }); } ``` #### Monitor Indonesian Volcanoes ```javascript const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { country: 'Indonesia', limit: 100 }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); console.log(`Active volcanoes in Indonesia: ${items.length}`); const advisory = items.filter(v => v.alertLevel === 'ADVISORY'); const warning = items.filter(v => v.alertLevel === 'WARNING'); const critical = items.filter(v => v.alertLevel === 'CRITICAL'); console.log(` ADVISORY: ${advisory.length}`); console.log(` WARNING: ${warning.length}`); console.log(` CRITICAL: ${critical.length}`); ``` ### Use Cases #### 1. Disaster Management ```javascript // Monitor volcanoes at WARNING level for emergency planning async function checkVolcanicThreats() { const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { alertLevel: 'WARNING', limit: 100 }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); for (const volcano of items) { // Trigger evacuation planning await initiateEmergencyResponse(volcano); } } ``` #### 2. Aviation Safety ```javascript // Check volcanic ash hazards for flight planning async function checkAirspaceSafety(flightRoute) { const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { alertLevel: 'ADVISORY', // ADVISORY and above limit: 100 }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); // Calculate distance from flight route const nearbyVolcanoes = items.filter(v => isNearRoute(v.latitude, v.longitude, flightRoute) ); if (nearbyVolcanoes.length > 0) { console.log('WARNING: Volcanic hazard detected near route'); return false; // Do not clear for flight } return true; } ``` #### 3. Tourism & Travel Advisory ```javascript // Check volcano safety before recommending destinations async function isSafeToVisit(country) { const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { country: country, alertLevel: 'WARNING', limit: 50 }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); if (items.length > 0) { console.log(`Travel warning: ${items.length} volcanoes at WARNING level`); return false; } return true; } ``` #### 4. Insurance & Risk Assessment ```javascript // Assess volcanic risk for property insurance async function assessVolcanicRisk(latitude, longitude) { const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { limit: 1000 // Get all volcanoes }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); // Calculate distance to nearest volcano let nearestVolcano = null; let minDistance = Infinity; items.forEach(volcano => { const dist = calculateDistance( latitude, longitude, volcano.latitude, volcano.longitude ); if (dist < minDistance) { minDistance = dist; nearestVolcano = volcano; } }); if (minDistance < 50) { // Within 50 km return { risk: 'HIGH', volcano: nearestVolcano, distanceKm: minDistance }; } return { risk: 'LOW' }; } ``` #### 5. Climate & Research Monitoring ```javascript // Monitor volcanic activity for climate/stratospheric research async function trackVolcanicEmissions() { const run = await Apify.call('ntriqpro/usgs-volcanic-activity-tracker', { alertLevel: 'ADVISORY', // Active or elevated activity limit: 500 }); const dataset = await Apify.openDataset(run.defaultDatasetId); const { items } = await dataset.getData(); // Store for SO2/ash tracking correlation await storeForAnalysis(items); // Alert if major eruption detected const warnings = items.filter(v => v.alertLevel === 'WARNING'); if (warnings.length > 0) { await notifyScientists('Major volcanic activity detected', warnings); } } ``` ### Supported Countries The USGS monitors volcanoes in 80+ countries and territories. Common countries include: | Region | Countries | |--------|-----------| | **North America** | United States, Canada, Mexico | | **Central America** | Guatemala, El Salvador, Nicaragua, Costa Rica, Panama | | **South America** | Ecuador, Peru, Colombia, Chile, Argentina | | **Caribbean** | Montserrat, St. Lucia, Dominica | | **Asia-Pacific** | Indonesia, Philippines, Japan, New Zealand, Papua New Guinea | | **Africa** | Ethiopia, Democratic Republic of Congo | | **Europe** | Iceland, Italy (Sicily), Greece | | **Others** | Russia, Vanuatu, Samoa | For a complete list: https://volcanoes.usgs.gov/ ### Data Quality & Limitations #### Accuracy - Data updated **daily** from USGS monitoring networks - Alert levels assigned by USGS Volcano Disaster Assistance Program (VDAP) scientists - Coordinates are WGS84 geographic (latitude/longitude) - Elevations in meters above sea level #### Limitations 1. **Not Real-Time** — Updates typically once per day (1-2 hour delay possible) 2. **Limited Volcanoes** — Only 1,300+ monitored globally; many remote volcanoes not tracked 3. **Alert Bias** — Remote/low-population volcanoes may have NORMAL status despite activity 4. **Funding Dependent** — USGS monitoring dependent on federal funding 5. **No Forecasting** — Provides current state only; doesn't predict eruptions #### For Critical Decisions For aviation, evacuation, or public safety decisions: 1. **Cross-check sources** — Also check local volcanic institutes and government warnings 2. **Monitor updates** — Run this API daily or set up monitoring 3. **Use with expert judgment** — Combine with satellite imagery (NASA, ESA) and seismic data 4. **Contact USGS** — For urgent questions: https://volcanoes.usgs.gov/ ### Pricing **Pay-per-event model:** - Per API call: $0.01 - No subscription required - Only pay when you run queries Example costs: - Daily monitoring: ~$0.31/month (1 call/day) - Hourly monitoring: ~$7.20/month (24 calls/day) - Real-time system: Custom volume pricing ### Legal - **USGS Data** — Public Domain (US Government) - **No Warranty** — Data provided "as-is" without warranty - **Attribution** — Please credit "USGS Volcano Disaster Assistance Program" - **Compliance** — No personal data collection, government open data only ### Best Practices 1. **Daily Monitoring** — Set up daily checks for critical regions 2. **Stakeholder Alerts** — If WARNING or CRITICAL detected, notify relevant parties immediately 3. **Historical Tracking** — Log results over time to identify trends 4. **Combine Sources** — Cross-reference with seismic networks and local institutes 5. **Expert Review** — For anything affecting public safety, involve geological experts ### External Resources - **USGS Volcano Disaster Assistance Program:** https://volcanoes.usgs.gov/ - **Smithsonian Institution GVP:** https://volcano.si.edu/ - **Real-time Seismic Data:** https://earthquake.usgs.gov/ - **NASA FIRMS (Thermal Alerts):** https://firms.modaps.eosdis.nasa.gov/ - **European Volcanological Society:** https://www.cev-cveg.be/ ### Support - USGS Volcano API: https://volcanoes.usgs.gov/vsc/api/ - USGS Volcano Hazards: https://volcanoes.usgs.gov/hazards/ - Contact: geology@ntriq.co.kr *** *This actor is part of the ntriq Disaster Intelligence platform. Updated 2026-03.* # Actor input Schema ## `mode` (type: `string`): Select the type of hiring signal analysis to perform ## `company` (type: `string`): Company ATS subdomain slug (e.g., stripe, notion, openai). Used for company\_jobs and department\_analysis modes. ## `atsUrl` (type: `string`): Direct URL to the company's public ATS board (e.g., https://boards.greenhouse.io/stripe). Overrides company if provided. ## `companies` (type: `array`): List of company slugs for bulk hiring\_trends or job\_search analysis (e.g., \["stripe", "notion", "openai"]). ## `keyword` (type: `string`): Keyword to filter jobs by title or description in job\_search mode (e.g., engineer, product manager). ## Actor input object example ```json { "mode": "company_jobs", "company": "stripe", "companies": [], "keyword": "engineer" } ``` # Actor output Schema ## `results` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("ntriqpro/usgs-volcanic-activity-tracker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("ntriqpro/usgs-volcanic-activity-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call ntriqpro/usgs-volcanic-activity-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ntriqpro/usgs-volcanic-activity-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "USGS Volcanic Activity Tracker - Free Volcano Monitoring API", "description": "Free API for USGS volcano monitoring and eruption alerts. No subscription. Track active volcanoes, alert levels, locations, recent activity. Government data, pay-per-use.", "version": "1.0", "x-build-id": "U3O7hR8mFGMkjd9gt" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ntriqpro~usgs-volcanic-activity-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ntriqpro-usgs-volcanic-activity-tracker", "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/ntriqpro~usgs-volcanic-activity-tracker/runs": { "post": { "operationId": "runs-sync-ntriqpro-usgs-volcanic-activity-tracker", "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/ntriqpro~usgs-volcanic-activity-tracker/run-sync": { "post": { "operationId": "run-sync-ntriqpro-usgs-volcanic-activity-tracker", "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": [ "mode" ], "properties": { "mode": { "title": "Analysis Mode", "enum": [ "company_jobs", "hiring_trends", "department_analysis", "job_search" ], "type": "string", "description": "Select the type of hiring signal analysis to perform", "default": "company_jobs" }, "company": { "title": "Company Slug", "type": "string", "description": "Company ATS subdomain slug (e.g., stripe, notion, openai). Used for company_jobs and department_analysis modes.", "default": "stripe" }, "atsUrl": { "title": "ATS URL", "type": "string", "description": "Direct URL to the company's public ATS board (e.g., https://boards.greenhouse.io/stripe). Overrides company if provided." }, "companies": { "title": "Companies", "type": "array", "description": "List of company slugs for bulk hiring_trends or job_search analysis (e.g., [\"stripe\", \"notion\", \"openai\"]).", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Job Keyword", "type": "string", "description": "Keyword to filter jobs by title or description in job_search mode (e.g., engineer, product manager).", "default": "engineer" } } }, "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 } } } } } } } } } } ```