Machine-to-Machine (M2M) API
URL: https://m2m.cr.usgs.gov/api/docs/json
USGS/EROS Machine-to-Machine (M2M) Application Programming Interface (API) is an alternative method of searching and acquiring data from the USGS/EROS data inventories. The M2M API provides the same options and functions as EarthExplorer (EE). The M2M API method includes:Discover data collections, search for imagery and request metadata, this API provides metadata access to all data sets that are also in EarthExplorer.Request and retrieve data download URLs that can be used with wget, cURL and other scriptable means.Utilizes RESTful JSON API for accessing more than 300 unique USGS/EROS datasets, providing a standardized interface across different metadata and data access capabilities.All interaction with this service follows JSON specifications and uses the 'application/json' content type.
There are no views created for this resource yet.
Additional Information
| Field | Value |
|---|---|
| Data last updated | January 7, 2026 |
| Metadata last updated | January 7, 2026 |
| Created | January 7, 2026 |
| Format | application/vnd.api+json |
| License | No License Provided |
| Accesscontrolrights | <p><span style="color: rgb(33, 37, 41);">This service is provided "as is" without guarantee of technical assistance. </span><a href="mailto:custserv@usgs.gov" rel="noopener noreferrer" target="_blank" style="color: rgb(0, 0, 238); background-color: rgb(255, 255, 255);">USGS/EROS User Services</a><span style="color: rgb(33, 37, 41);"> may be able to answer some questions and provide very limited technical support. When requesting assistance, be prepared to provide your ERS userid, IP address, the contents of your request and the response, and any additional information that may help the investigation. Before reporting an issue, please debug your code thoroughly to ensure the error is not in your code. The </span><strong style="color: rgb(33, 37, 41);">API Usage</strong><span style="color: rgb(33, 37, 41);"> and </span><strong style="color: rgb(33, 37, 41);">Common Issues</strong><span style="color: rgb(33, 37, 41);"> sections below may help direct debugging efforts.</span></p><p><br></p><p><span style="color: rgb(33, 37, 41);">USGS may restrict or block usage that falls outside the usage expectations and limitations.</span></p> |
| Codeaccessurl | https://m2m.cr.usgs.gov/api/docs/examples/ |
| Datastore active | False |
| Docsurl | https://m2m.cr.usgs.gov/api/docs/json/ |
| Endpointdesc | This API uses a tiered version system. Users should use the 'stable' version unless directed otherwise, such as to access experimental features. New 'stable' versions will retain backward compatibility with previous features unless announced. When necessary, backward-incompatible changes will be announced at least 3 months before the update. Users should periodically check the 'notifications' endpoint for important announcements and updates. The application token is a 64-bit encrypted string that can be used in the Machine-2-Machine API 'login-token' endpoint to authenticate with this token instead of your ERS password. See API token and key documentation at: https://d9-wret.s3.us-west-2.amazonaws.com/assets/palladium/production/s3fs-public/media/files/M2M%20Application%20Token%20Documentation_02112025_0.pdf |
| Endpointname | Machine-to-Machine API |
| Has views | False |
| Id | eefe597a-a2e3-4562-9411-73c44bd18632 |
| Issuedate | 2021-12-21 |
| Lastupdatedate | 2025-02-28 |
| Mimetype | application/vnd.api+json |
| Package id | 1d216725-75d7-40b1-99ab-21a29d3f0961 |
| Position | 0 |
| State | active |
| Status | active |
| Urltype | api-endpoint |