OpenCaged Geocoder (Open Source option)

OpenCaged Geocoder (Open Source option) — free tier with API key

📚 Open DataON SCHEDULE
AUTH APIKEYCORS AGENT ?HTTPS COMMERCIAL ?

OpenCaged Geocoder (Open Source option) exposes a free-tier JSON API. Register for an API key if required; we verified a public or demo endpoint.

REACHABILITY SCORE ⓘ
Status badge · for your READMEshipapis health badge: — · unmonitored
ON PROBE SCHEDULE

We probe without your API key. A 401/403 auth wall means the server is up — not a full health pass. Open provider docs ↗

Uptime historystarts after first probe

On our probe schedule. Uptime charts appear after the first check lands.

Example responsefrom provider docs — not verified by us
GET https://api.opencagedata.com/geocode/v1/json?key=YOUR_API_KEY&q=52.5432379%2C+13.4142133&pretty=1&no_annotations=1

{
  "documentation": "https://opencagedata.com/api",
  "licenses": [
    {
      "name": "see attribution guide",
      "url": "https://opencagedata.com/credits"
    }
  ],
  "rate": {
    "limit": 2500,
    "remaining": 2499,
    "reset": 1783296000
  },
  "results": [
    {
      "bounds": {
        "northeast": {
          "lat": 51.9527122,
          "lng": 7.6325209
        },
        "southwest": {
          "lat": 51.9526122,
          "lng": 7.6324209
        }
      },
      "components": {
        "ISO_3166-1_alpha-2": "DE",
        "ISO_3166-1_alpha-3": "DEU",
        "ISO_3166-2": [
          "DE-NW"
        ],
        "_category": "social",
        "_normalized_city": "Münster",
        "_type": "social_facility",
        "city": "Münster",
        "city_district": "Münster-Mitte"
      },
      "confidence": 9,
      "distance_from_q": {
        "meters": 0
      },
      "formatted": "Chance e.V., Friedrich-Ebert-Straße 7, 48153 Münster, Deutschland",
      "geometry": {
        "lat": 51.9526622,
        "lng": 7.6324709
      }
    }
  ],
  "status": {
    "code": 200,
    "message": "OK"
  },
  "stay_informed": {
    "blog": "https://blog.opencagedata.com",
    "mastodon": "https://en.osm.town/@opencage"
  },
  "thanks": "For using an OpenCage API",
  "timestamp": {
    "created_http": "Sun, 05 Jul 2026 23:27:44 GMT",
    "created_unix": 1783294064
  }
}
Call itcurl · fetch · python
curl "https://api.opencagedata.com/geocode/v1/json?key=YOUR_API_KEY&q=52.5432379%2C+13.4142133&pretty=1&no_annotations=1"
const res = await fetch("https://api.opencagedata.com/geocode/v1/json?key=YOUR_API_KEY&q=52.5432379%2C+13.4142133&pretty=1&no_annotations=1");
const data = await res.json();
console.log(data);
import requests

res = requests.get("https://api.opencagedata.com/geocode/v1/json?key=YOUR_API_KEY&q=52.5432379%2C+13.4142133&pretty=1&no_annotations=1")
print(res.json())
Endpoints · 6On scheduleFULL DOCS ↗
On schedule — auth-wall reachability checks pending
GET/geocode/v1/json?key=YOUR_API_KEY&q=52.5432379%2C+13.4142133&pretty=1&no_annotations=1PROBED

OpenCaged Geocoder (Open Source option) — free tier with API key

GET/geocode

Geocode — documented GET route.

GET/geocode/1

Geocode details by ID (example: 1).

GET/geocode?limit=10

Geocode — documented GET route.

GET/geocode/search?q=test

Search by query parameters.

GET/geocode/v1/json?limit=5

Json — documented GET route.

Machine-readable spec

We probe without your API key. A 401/403 auth wall means the server is up — not a full health pass. Export includes every documented route below.

Response-shape history

Not tracked yet. Shape-change history starts once this API joins our probe schedule.

OpenCaged Geocoder (Open Source option): common questions

Is OpenCaged Geocoder (Open Source option) free to use?

Yes — OpenCaged Geocoder (Open Source option) is a free open data API. Free tier: Free tier — API key required. Whether the free tier allows commercial use is unclear — check the provider docs.

Does OpenCaged Geocoder (Open Source option) need an API key?

Yes — OpenCaged Geocoder (Open Source option) needs a free API key, which you pass on each request. Rate limits: Unpublished.

Can I call OpenCaged Geocoder (Open Source option) from the browser?

Yes — OpenCaged Geocoder (Open Source option) returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.

Is OpenCaged Geocoder (Open Source option) up right now?

OpenCaged Geocoder (Open Source option) is catalogued but not yet on our probe schedule, so we don't publish a live status for it. Check the provider's own status page or docs for its current state.