# Usgs

6 endpoints on Usgs. Every one returns the same response shape and has a flat, published price in credits.

Category: [Maps, weather & space](https://onekey.dev/docs/categories/earth.md) · [Overview page](https://onekey.dev/platforms/usgs)

## Endpoints

| Endpoint | What it does | Cost | Status |
| --- | --- | --- | --- |
| [`earthquake`](https://onekey.dev/docs/api/usgs/earthquake.md) | One USGS earthquake event by id. | 1 credit | stable |
| [`earthquake_count`](https://onekey.dev/docs/api/usgs/earthquake_count.md) | Count of earthquakes at or above a magnitude since a date. | 1 credit | stable |
| [`earthquake_search`](https://onekey.dev/docs/api/usgs/earthquake_search.md) | Search earthquakes (FDSN query): minimum magnitude, newest first. | 5 credits | stable |
| [`earthquakes`](https://onekey.dev/docs/api/usgs/earthquakes.md) | Recent earthquakes from a USGS summary feed (e.g. 2.5_day, significant_week). | 5 credits | stable |
| [`earthquakes_near`](https://onekey.dev/docs/api/usgs/earthquakes_near.md) | Earthquakes within a radius of a point (FDSN query), newest first. | 5 credits | stable |
| [`streamflow`](https://onekey.dev/docs/api/usgs/streamflow.md) | Latest instantaneous streamflow (discharge) for a USGS gauge site. | 1 credit | stable |

Every endpoint page has a **Field mapping** section showing which source field becomes which [unified field](https://onekey.dev/docs/schema.md) (fixed schema) or platform-specific `ext.` field.