OpenCage API

by opencagedata.com

API keyHTTPSCORSGeocoding

Overview

Forward and reverse geocoding using open data

OpenCage is a geocoding API from opencagedata.com. Requests are authenticated with an API key. It is served over HTTPS and allows browser requests (CORS). Its OpenAPI description documents 1 endpoints.

At a glance

Authentication: API key
HTTPS: Yes
CORS: Yes
Category: Geocoding
Base URL: https://api.opencagedata.com/geocode
Version: 1
Endpoints: 1
OpenAPI: Specification ↗
Spec updated: 2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://api.opencagedata.com/geocode/vVERSION/FORMAT" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const response = await fetch("https://api.opencagedata.com/geocode/vVERSION/FORMAT", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://api.opencagedata.com/geocode/vVERSION/FORMAT",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())