# USGS Volcano Alerts Scraper (`parseforge/usgs-volcano-alerts-scraper`) Actor

Track live volcano alert levels and aviation color codes from the USGS Volcano Hazards Program across five U.S. observatories. Each record returns volcano name, VNUM, alert level, color code, latitude, longitude, and the latest notice link. Built for aviation safety and hazard maps.

- **URL**: https://apify.com/parseforge/usgs-volcano-alerts-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Automation, Developer tools, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🌋 USGS Volcano Alerts Scraper

> 🚀 **Track every monitored U.S. volcano in seconds.** Pull live alert levels, aviation color codes, and notices for all 69 volcanoes watched by the USGS Volcano Hazards Program.

> 🕒 **Last updated:** 2026-06-05 · **📊 19 fields** per record · 5 USGS observatories · Alaska, Cascades, California, Hawaii, and Yellowstone

The USGS Volcano Alerts Scraper reads directly from the USGS Hazard Notification System (HANS) public API and returns a clean, structured record for each monitored volcano. Every record carries the current Volcano Alert Level (NORMAL, ADVISORY, WATCH, WARNING), the Aviation Color Code (GREEN, YELLOW, ORANGE, RED), the responsible observatory, the latest notice, and precise geographic coordinates.

Coverage spans all five U.S. volcano observatories: Alaska (AVO), Cascades (CVO), California (CalVO), Hawaii (HVO), and Yellowstone (YVO). Choose between the full monitored list or only the volcanoes currently at an elevated alert, and optionally narrow results to a single observatory.

| 🎯 Target Audience | 💡 Primary Use Cases |
|---|---|
| Aviation dispatchers and flight planners | Monitor aviation color codes along flight paths |
| Emergency managers and researchers | Track alert level changes across regions |
| Journalists and data teams | Build dashboards and trigger alert notifications |
| Geoscience educators and hobbyists | Map active volcanoes with live status |

### 📋 What the USGS Volcano Alerts Scraper does

- Reads the USGS HANS public API for volcano alert and notice data.
- Returns the full monitored list (always 5 or more records) or only elevated volcanoes.
- Maps each volcano to its Volcano Alert Level and Aviation Color Code.
- Enriches every record with region, latitude, longitude, and summit elevation.
- Resolves the latest notice type, identifier, sent timestamp, and notice link.
- Lets you filter to a single observatory (AVO, CVO, CalVO, HVO, YVO).

### 🎬 Full Demo (_🚧 Coming soon_)

### ⚙️ Input

| Field | Type | Description |
|---|---|---|
| `mode` | select | `all` returns the full monitored list (5 or more records). `elevated` returns only volcanoes at an elevated alert. Default `all`. |
| `observatory` | select | Limit results to one observatory (`avo`, `calvo`, `cvo`, `hvo`, `yvo`). Leave blank for all. |
| `maxItems` | integer | Free users limited to 10 items. Paid users up to 1,000,000. |

**Example 1 — all monitored volcanoes:**

```json
{
  "mode": "all",
  "maxItems": 10
}
````

**Example 2 — only elevated volcanoes in Alaska:**

```json
{
  "mode": "elevated",
  "observatory": "avo",
  "maxItems": 50
}
```

> ⚠️ **Good to Know:** On calm days the elevated list can have fewer than 5 volcanoes. Use `mode: all` (the default) to always receive the complete monitored list, where quiet volcanoes are reported as NORMAL / GREEN.

### 📊 Output

Each record contains the following fields.

| Field | Description |
|---|---|
| 🌋 `volcanoName` | Volcano name |
| 🆔 `vnum` | USGS volcano number (VNUM) |
| 🏛 `observatory` | Full observatory name |
| 🔡 `observatoryCode` | Observatory abbreviation |
| 🚨 `alertLevel` | Volcano Alert Level (NORMAL, ADVISORY, WATCH, WARNING) |
| ✈️ `aviationColorCode` | Aviation Color Code (GREEN, YELLOW, ORANGE, RED) |
| 🗺 `region` | Geographic region |
| 📍 `latitude` | Latitude |
| 📍 `longitude` | Longitude |
| ⛰ `elevationMeters` | Summit elevation in meters |
| 📰 `noticeType` | Human readable notice type |
| 🔤 `noticeTypeCode` | Notice type code |
| 🧾 `noticeIdentifier` | Notice identifier |
| 🕒 `sentUtc` | Notice sent timestamp (UTC) |
| ⏱ `sentUnixtime` | Notice sent Unix timestamp |
| 🔗 `noticeUrl` | Link to the full notice |
| 🌐 `volcanoUrl` | Link to the volcano information page |
| 🕒 `scrapedAt` | Collection timestamp |
| ❌ `error` | Error message, null on success |

**Sample records (real output):**

```json
{
  "volcanoName": "Akutan",
  "vnum": "311320",
  "observatory": "Alaska Volcano Observatory",
  "observatoryCode": "avo",
  "alertLevel": "NORMAL",
  "aviationColorCode": "GREEN",
  "region": "Aleutians",
  "latitude": 54.13308,
  "longitude": -165.98555,
  "elevationMeters": 1303,
  "noticeType": "Information Statement",
  "noticeTypeCode": "IS",
  "noticeIdentifier": "DOI-USGS-AVO-2019-09-04T15:47:55-08:00",
  "sentUtc": "2019-09-06 18:29:39",
  "sentUnixtime": 1567794579,
  "noticeUrl": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2019-09-04T15:47:55-08:00",
  "volcanoUrl": "https://avo.alaska.edu/volcanoes/volcinfo.php?volcname=Akutan",
  "scrapedAt": "2026-06-05T17:25:58.055Z",
  "error": null
}
```

```json
{
  "volcanoName": "Aniakchak",
  "vnum": "312090",
  "observatory": "Alaska Volcano Observatory",
  "observatoryCode": "avo",
  "alertLevel": "NORMAL",
  "aviationColorCode": "GREEN",
  "region": "Alaska Peninsula",
  "latitude": 56.9058,
  "longitude": -158.209,
  "elevationMeters": 1341,
  "noticeType": "Information Statement",
  "noticeTypeCode": "IS",
  "noticeIdentifier": "DOI-USGS-AVO-2026-05-05T20:15:40+00:00",
  "sentUtc": "2026-05-05 22:31:29",
  "sentUnixtime": 1778020289,
  "noticeUrl": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-05-05T20:15:40+00:00",
  "volcanoUrl": "https://avo.alaska.edu/activity/Aniakchak.php",
  "scrapedAt": "2026-06-05T17:25:58.260Z",
  "error": null
}
```

```json
{
  "volcanoName": "Great Sitkin",
  "vnum": "311120",
  "observatory": "Alaska Volcano Observatory",
  "observatoryCode": "avo",
  "alertLevel": "WATCH",
  "aviationColorCode": "ORANGE",
  "region": "Aleutians",
  "latitude": 52.0765,
  "longitude": -176.1109,
  "elevationMeters": 1740,
  "noticeType": "Daily Update",
  "noticeTypeCode": "DU",
  "noticeIdentifier": "DOI-USGS-AVO-2026-06-04T19:17:45+00:00",
  "sentUtc": "2026-06-04 19:24:56",
  "sentUnixtime": 1780601096,
  "noticeUrl": "https://volcanoes.usgs.gov/hans-public/notice/DOI-USGS-AVO-2026-06-04T19:17:45+00:00",
  "volcanoUrl": "https://avo.alaska.edu/volcano/great-sitkin",
  "scrapedAt": "2026-06-05T17:25:58.500Z",
  "error": null
}
```

### ✨ Why choose this Actor

- Reads the official USGS HANS public source, no scraping of fragile HTML.
- Always returns at least 5 records in the default mode, even on quiet days.
- Pairs each alert with exact coordinates and summit elevation.
- Both the Volcano Alert Level and the Aviation Color Code in one record.
- Simple inputs, predictable structure, ready for dashboards and automations.

### 📈 How it compares to alternatives

| Approach | Alert Level | Aviation Color | Coordinates | Latest Notice |
|---|---|---|---|---|
| This Actor | ✅ | ✅ | ✅ | ✅ |
| Manual website checks | ✅ | ✅ | partial | manual |
| Generic RSS readers | partial | partial | ❌ | ✅ |

### 🚀 How to use

1. [Sign up for a free Apify account](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the USGS Volcano Alerts Scraper.
3. Pick a `mode` (`all` or `elevated`) and an optional observatory.
4. Set `maxItems` and click Start.
5. Collect your structured volcano alert records when the run finishes.

### 💼 Business use cases

#### Aviation safety

| Need | How this helps |
|---|---|
| Avoid ash hazards | Track Aviation Color Codes along routes |
| Route planning | Map elevated volcanoes by coordinates |

#### Emergency management

| Need | How this helps |
|---|---|
| Situational awareness | Monitor alert level changes by region |
| Public alerting | Trigger notifications on WATCH or WARNING |

#### Media and journalism

| Need | How this helps |
|---|---|
| Breaking coverage | Detect new notices as they post |
| Context | Pull notice links and summaries |

#### Research and analytics

| Need | How this helps |
|---|---|
| Trend tracking | Build a time series of alert states |
| Geospatial work | Use coordinates and elevation directly |

### 🔌 Automating USGS Volcano Alerts Scraper

Connect this Actor to Make, Zapier, Slack, Airbyte, GitHub, or Google Drive to push fresh volcano alerts into your workflows. Schedule recurring runs and route elevated alerts to the channels your team already uses.

### 🌟 Beyond business use cases

- **Research:** assemble datasets of historical alert states for study.
- **Personal:** keep an eye on volcanoes near places you care about.
- **Non-profit:** support community preparedness and education.
- **Experimentation:** prototype geospatial maps and alerting bots.

### 🤖 Ask an AI assistant

Ask [ChatGPT](https://chat.openai.com/), [Claude](https://claude.ai/), [Perplexity](https://www.perplexity.ai/), or [Microsoft Copilot](https://copilot.microsoft.com/) to summarize which volcanoes are currently at WATCH or WARNING from this Actor's output.

### ❓ Frequently Asked Questions

**Which volcanoes are covered?**
All volcanoes monitored by the five USGS volcano observatories, currently 69 records.

**What is the difference between alert level and aviation color code?**
The Volcano Alert Level describes ground hazards. The Aviation Color Code describes hazards to aircraft from ash.

**Why does the elevated mode sometimes return fewer than 5 records?**
Because few volcanoes are elevated on calm days. Use `mode: all` for the complete list.

**Where does the data come from?**
The USGS Hazard Notification System (HANS) public API.

**Can I filter by observatory?**
Yes, set `observatory` to `avo`, `calvo`, `cvo`, `hvo`, or `yvo`.

**Are coordinates included?**
Yes, latitude, longitude, and summit elevation are included for each volcano with a VNUM.

**How fresh is the data?**
Each run reads the current state of the HANS API at run time.

**What does the notice link contain?**
The full official notice published by the responsible observatory.

**Is a NORMAL volcano still useful?**
Yes, a baseline of NORMAL states is valuable for trend tracking and mapping.

**Can I schedule runs?**
Yes, use Apify scheduling to run this Actor on a recurring basis.

### 🔌 Integrate with any app

Use the Apify API and integrations to send results to your database, spreadsheet, or messaging tools, or to trigger downstream actions on alert changes.

### 🔗 Recommended Actors

- [ParseForge collection](https://apify.com/parseforge) for more government and open data scrapers.
- Explore additional hazard, weather, and geoscience Actors on the ParseForge profile.

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge).

**🆘 Need Help?** [Open our contact form](https://tally.so/r/BzdKgA)

> **⚠️ Disclaimer:** independent tool, not affiliated with the USGS. Only publicly available data collected.

# Actor input Schema

## `mode` (type: `string`):

Choose which volcanoes to return. 'all' returns the full monitored list (always 5 or more records, with NORMAL/GREEN where no elevated alert is active). 'elevated' returns only volcanoes currently at an elevated alert level or aviation color code.

## `observatory` (type: `string`):

Optionally limit results to a single USGS volcano observatory. Leave blank to include every observatory.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## Actor input object example

```json
{
  "mode": "all",
  "observatory": "",
  "maxItems": 10
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/usgs-volcano-alerts-scraper").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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "maxItems": 10 }

# Run the Actor and wait for it to finish
run = client.actor("parseforge/usgs-volcano-alerts-scraper").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 '{
  "maxItems": 10
}' |
apify call parseforge/usgs-volcano-alerts-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/usgs-volcano-alerts-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "USGS Volcano Alerts Scraper",
        "description": "Track live volcano alert levels and aviation color codes from the USGS Volcano Hazards Program across five U.S. observatories. Each record returns volcano name, VNUM, alert level, color code, latitude, longitude, and the latest notice link. Built for aviation safety and hazard maps.",
        "version": "0.1",
        "x-build-id": "Gz8suqnkbRpdV2ANv"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/parseforge~usgs-volcano-alerts-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-parseforge-usgs-volcano-alerts-scraper",
                "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/parseforge~usgs-volcano-alerts-scraper/runs": {
            "post": {
                "operationId": "runs-sync-parseforge-usgs-volcano-alerts-scraper",
                "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/parseforge~usgs-volcano-alerts-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-parseforge-usgs-volcano-alerts-scraper",
                "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": {
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "all",
                            "elevated"
                        ],
                        "type": "string",
                        "description": "Choose which volcanoes to return. 'all' returns the full monitored list (always 5 or more records, with NORMAL/GREEN where no elevated alert is active). 'elevated' returns only volcanoes currently at an elevated alert level or aviation color code.",
                        "default": "all"
                    },
                    "observatory": {
                        "title": "Observatory Filter",
                        "enum": [
                            "",
                            "avo",
                            "calvo",
                            "cvo",
                            "hvo",
                            "yvo"
                        ],
                        "type": "string",
                        "description": "Optionally limit results to a single USGS volcano observatory. Leave blank to include every observatory.",
                        "default": ""
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "minimum": 1,
                        "maximum": 1000000,
                        "type": "integer",
                        "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```