Skip to main content
API v2.0.0 is now available! The v1 API is now in legacy mode. We strongly recommend migrating to v2 for a unified endpoint, better filtering, and improved features. Learn more about v2 or view migration guide.

​
Welcome

The AVERT Imagery API v1 (legacy) provides programmatic access to infrared and visible images captured by cameras directed towards target volcanoes. This API allows researchers and developers to query, filter, and download volcanic imagery data for analysis and monitoring purposes.
Looking for the latest API? Check out API v2.0.0 for a unified endpoint, advanced filtering, smart downloads, and more.

​
Available Endpoints

Our API currently supports two types of imagery data:

Infrared Imagery

Query and download infrared thermal images from Cleveland volcano

Visible Imagery

Query and download visible light images from Cleveland and Okmok volcanoes

​
Base URL

All API requests should be made to: 
https://avert-legacy.ldeo.columbia.edu/api

​
Authentication

The AVERT Imagery API currently operates without authentication requirements for public data access. All endpoints are publicly accessible for research and educational purposes.

​
Rate Limits

To ensure fair usage and system stability:
  • Query endpoints: Limited to reasonable request rates
  • Download endpoints: Bulk downloads (>100 images) should use individual image endpoints
  • Zip downloads: Only available for queries returning ≤100 results

​
Getting Started

To start using the API, you’ll need:
  1. A site identifier (e.g., “CLNE” for Cleveland Northeast)
  2. A volcano number (vnum) for the target volcano
  3. Optional time range parameters for filtering results
Check out our endpoint documentation for detailed examples and interactive API playground.

Interactive Playground

Test API endpoints directly in your browser (may have display limitations)

Reliable Testing Tools

Postman, cURL, Python, and JavaScript examples that work perfectly
Recommended: For the best testing experience, use our API Testing Alternatives. The playground may have display issues with JSON responses, but these tools work flawlessly with the AVERT API.