# GraphHopper Directions API

**Provider:** GraphHopper Directions
**Category:** maps
**Base URL:** `https://graphhopper.com/api/1`
**Auth:** api-key — `GET /endpoint?key=YOUR_KEY`
**Rate Limit:** 500 req/day (free)
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://api.apis.guru/v2/specs/graphhopper.com/1.0.0.json

## Description

With the GraphHopper Directions API you can integrate A-to-B route planning, turn-by-turn navigation,
route optimization, isochrone calculations and other tools in your application.

The GraphHopper Directions API consists of the following RESTful web services:

 * Routing API,
 * Route Optimization API,

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://graphhopper.com/api/1/cluster` | POST Cluster Endpoint |
| POST | `https://graphhopper.com/api/1/cluster/calculate` | Batch Cluster Endpoint |
| GET | `https://graphhopper.com/api/1/cluster/solution/{jobId}` | GET Batch Solution Endpoint |
| GET | `https://graphhopper.com/api/1/geocode` | Geocoding Endpoint |
| GET | `https://graphhopper.com/api/1/isochrone` | Isochrone Endpoint |
| POST | `https://graphhopper.com/api/1/match` | Map-match a GPX file |
| GET | `https://graphhopper.com/api/1/matrix` | GET Matrix Endpoint |
| POST | `https://graphhopper.com/api/1/matrix` | POST Matrix Endpoint |

## Authentication

API key as query parameter (key)

```
GET /endpoint?key=YOUR_KEY
```

## Sample Request

```bash
curl 'https://graphhopper.com/api/1/cluster' \
  -H 'GET /endpoint?key=YOUR_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

GraphHopper Directions API. Free: 500 req/day. Standard €29/mo (10K req/day). Professional €99/mo. Premium €499/mo. Open-source self-hosting available.

---

*Source: [API Map](https://apimap.dev/apis/graphhopper-directions/) — CC BY 4.0*