> ## Documentation Index
> Fetch the complete documentation index at: https://docs.terraquakeapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TerraQuake API

> A developer-friendly REST API for exploring and analyzing seismic events across Italy and beyond

![TerraQuake API Hero Light](https://mintcdn.com/studio-cedb9d71/0zG4w_f4rpBImFS1/images/terraquake-icon.png?fit=max\&auto=format\&n=0zG4w_f4rpBImFS1\&q=85\&s=b016b6d0d8227ed56078b4489531183a)

## Welcome to TerraQuake API

TerraQuake API provides real-time access to seismic event data from the Italian National Institute of Geophysics and Volcanology (INGV). Whether you're building an earthquake monitoring dashboard, conducting research, or creating educational tools, our API makes it easy to access comprehensive earthquake data.

> **Real-time INGV Data**
>
> Access live earthquake data from INGV's official seismic network

> **Powerful Filtering**
>
> Filter earthquakes by magnitude, depth, region, date range, and location

> **Seismic Stations**
>
> Query information about seismic monitoring stations across Italy

> **GeoJSON Support**
>
> Get location data in GeoJSON format for easy mapping integration

## What can you do with TerraQuake API?

TerraQuake API offers comprehensive endpoints for accessing seismic data:

* **Recent Events**: Get earthquakes from today, last week, or recent months
* **Geographic Queries**: Find earthquakes near specific coordinates or within Italian regions
* **Advanced Filtering**: Filter by magnitude, depth, date ranges, and more
* **Station Data**: Access details about seismic monitoring stations and their status
* **Pagination & Sorting**: Efficiently navigate through large datasets

## Quick Example

Here's a simple example to get today's earthquakes:

```bash cURL theme={null}
curl https://api.terraquakeapi.com/v1/earthquakes/today?limit=10
```

```javascript JavaScript theme={null}
const response = await fetch(
  'https://api.terraquakeapi.com/v1/earthquakes/today?limit=10',
);
const data = await response.json();
console.log(data);
```

```python Python theme={null}
import requests

response = requests.get(
  'https://api.terraquakeapi.com/v1/earthquakes/today',
  params={'limit': 10}
)
data = response.json()
print(data)
```

> [!TIP]
>
> Most endpoints are public and don't require authentication. Get started
> immediately!

## Get Started

> **[Quickstart Guide](https://docs.terraquakeapi.com/quickstart.md)**
>
> Make your first API call in under 5 minutes

> **[API Reference](https://docs.terraquakeapi.com/api/earthquakes/overview.md)**
>
> Explore all available endpoints and parameters

> **[Authentication](https://docs.terraquakeapi.com/authentication.md)**
>
> Learn about authentication for protected endpoints

> **[Core Concepts](https://docs.terraquakeapi.com/concepts/response-format.md)**
>
> Understand pagination, rate limiting, and error handling

## Data Source

TerraQuake API fetches earthquake data directly from the **Italian National Institute of Geophysics and Volcanology (INGV)**, ensuring you always have access to the latest and most accurate seismic information available.

> [!NOTE]
>
> The API processes and enhances INGV data with features like pagination,
> flexible filtering, and consistent response formatting to make integration
> easier.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.