Skip to main content
Images captured by cameras directed towards our target volcanoes (currently Cleveland and Okmok, in the Aleutians) are available for browsing and download through our web archive browser, or can be downloaded via our data API using a command line tool, such as cURL, or the Python requests library. 📖 Complete API Documentation: For detailed API reference with interactive examples, see our Visible Imagery API Documentation.
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.
An example of how to access the data via the API is shown below: 
import requests

# Query for visible images
response = requests.get(
    "https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/query",
    params={
        "site": "CLNE",
        "vnum": 311240,
        "search_from": "2022-10-01T00:00",
        "search_to": "2022-10-02T00:00",
        "limit": 10  # Control result size
    }
)

images = response.json()

# Download images as ZIP if ≤100 results
if len(images) <= 100:
    zip_response = requests.get(
        "https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/query",
        params={
            "site": "CLNE",
            "vnum": 311240,
            "search_from": "2022-10-01T00:00",
            "search_to": "2022-10-02T00:00",
            "download": True
        }
    )
    with open("visible_images.zip", "wb") as f:
        f.write(zip_response.content)

# Or download individual images
for image in images:
    image_response = requests.get(
        f"https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image['image_id']}",
        params={"download": True}
    )
    with open(f"visible_{image['image_id']}.jpg", "wb") as f:
        f.write(image_response.content)