# OpenCage Geocoder

**Provider:** OpenCage Geocoder
**Category:** maps
**Base URL:** `https://api.opencagedata.com/geocode`
**Auth:** api-key — `GET /geocode/v1/json?q=Berlin&key=YOUR_API_KEY`
**Rate Limit:** 1 request/sec (free); 15 req/sec (paid)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://opencagedata.com/contact

## Description

Worldwide forward and reverse geocoding

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.opencagedata.com/geocode/v{version}/{format}` | geocode a query |

## Authentication

API key as a query parameter named key

```
GET /geocode/v1/json?q=Berlin&key=YOUR_API_KEY
```

## Sample Request

```bash
curl -X GET 'https://api.opencagedata.com/geocode/v{version}/{format}' \
  -H '# No auth required'
```

## Sample Response

```json
{}
```

## Pricing Details

Free: 2,500 req/day, 1 req/sec. Small: $50/mo (10k req/day). Medium: $200/mo (100k req/day). Large: $500/mo (unlimited).

---

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