# Copernicus Marine Toolbox API

**Canonical:** https://apis.io/apis/copernicus-marine/copernicus-marine-toolbox-api/  
**Provider:** Copernicus Marine — https://apis.io/providers/copernicus-marine/  
**Base URL:** https://data.marine.copernicus.eu  
**Documentation:** https://toolbox-docs.marine.copernicus.eu/

Copernicus Marine Toolbox API is one of 3 APIs that [Copernicus Marine](https://apis.io/providers/copernicus-marine/) publishes on the [APIs.io](https://apis.io/) network. Tagged areas include Ocean Data, Subsetting, NetCDF, Zarr, and Python. The published artifact set on APIs.io includes API documentation and a GitHub repository.

The Copernicus Marine Toolbox provides the officially supported programmatic interface to the Copernicus Marine Data Store, available as both a Python library and CLI. Core operations include describe (browse the full product catalogue and retrieve dataset metadata), subset (extract data by variable, geographic bounding box, time range, and depth range in NetCDF, Zarr, CSV, or Parquet formats), get (download original production files with wildcard and regex filtering), open_dataset (lazy-load datasets remotely via xarray), and read_dataframe (load data directly into pandas). The service offers no quota on data volume or bandwidth. Authentication uses username and password stored in a credentials file or environment variables COPERNICUSMARINE_SERVICE_USERNAME and COPERNICUSMARINE_SERVICE_PASSWORD. A free Copernicus Marine account is required.

## Machine-readable artifacts (6)

- **Documentation** — https://toolbox-docs.marine.copernicus.eu/
- **HelpCenter** — https://help.marine.copernicus.eu/en/collections/9080063-copernicus-marine-toolbox
- **GitHubRepository** — https://github.com/mercator-ocean/copernicus-marine-toolbox
- **PyPI** — https://pypi.org/project/copernicusmarine/
- **Registration** — https://data.marine.copernicus.eu/register
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/copernicus-marine/refs/heads/main/apis.yml

## Other Copernicus Marine APIs (2)

- [Copernicus Marine WMTS API](https://apis.io/apis/copernicus-marine/copernicus-marine-wmts-api/)
- [Copernicus Marine CSW Catalogue API](https://apis.io/apis/copernicus-marine/copernicus-marine-csw-catalogue-api/)

## Tags

Ocean Data, Subsetting, NetCDF, Zarr, Python, CLI, Download

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/copernicus-marine/copernicus-marine-toolbox-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/copernicus-marine/.
