Opencagedata OpenCage Geocoder

Name: OpenCage Geocoder API
Brand: OpenCage Geocoder
Availability: InStock

✓ Official Vendor SpecMaps GeolocationGeocodingapiKey3 EndpointsREST

For Agents

Geocode addresses to coordinates and reverse-geocode coordinates to formatted addresses worldwide using open data, with JSON, XML, or GeoJSON output.

Install Jentic One Beta

Connect the OpenCage Geocoder to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the OpenCage Geocoder, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with OpenCage Geocoder API.

Forward geocode a free-form address string into latitude and longitude with confidence scoring

Reverse geocode a latitude/longitude pair into a formatted address with administrative hierarchy

Bias geocoding results toward a specific country code, bounding box, or proximity point

GET STARTED

Start building with OpenCage Geocoder API

Explore with Jentic

View OpenAPI Document

OpenCage Geocoder is a worldwide forward and reverse geocoding API built on open data sources including OpenStreetMap, Natural Earth, and government-published gazetteers. It converts free-form place names and structured addresses into latitude and longitude coordinates, and reverses coordinates back into formatted addresses with administrative hierarchy and country codes. Responses are returned in JSON, XML, or GeoJSON to suit different mapping stacks. Subscription customers receive responses without the rate element or X-Ratelimit headers because they are not subject to hard daily caps.

Use Cases

Patterns agents use OpenCage Geocoder API for, with concrete tasks.

★ Address to Coordinates Conversion

Convert user-entered addresses into latitude and longitude for storage, mapping, or distance calculations. The /json endpoint accepts a q query string and returns ranked candidates with confidence, formatted address, and a components block covering country, state, city, postcode, and road. This suits signup flows, delivery interfaces, and CRM enrichment pipelines that need accurate placement.

GET /json?q=10+Downing+Street+London&key=YOUR_KEY and return the lat/lng and components.country_code from the first result.

Reverse Geocoding for Field Apps

Translate device GPS coordinates into a human-readable address for field-service, ride-hail, and delivery apps. Send the lat,lng pair to /json or /geojson and OpenCage returns a formatted address plus an annotations block with timezone, currency, and what3words tokens, removing the need to stitch together multiple gazetteer lookups.

GET /json?q=51.952659,7.632473&key=YOUR_KEY and return the formatted field plus the annotations.timezone.name.

GeoJSON Map Overlays

Generate GeoJSON FeatureCollections directly from address inputs to drive Leaflet or Mapbox overlays without a client-side conversion step. The /geojson endpoint returns the same geocoding data as /json but already wrapped in the GeoJSON shape, which fits cleanly into mapping libraries that expect Feature inputs.

GET /geojson?q=Eiffel+Tower&key=YOUR_KEY and pass the resulting FeatureCollection to L.geoJSON() to render a marker.

AI Agent Location Enrichment

Through Jentic, an AI agent enriches contact, order, or event records with coordinates and structured location components in a single search-load-execute cycle. This suits CRM agents that need to plot customers on a map, logistics agents that need to validate delivery addresses, and analytics agents that need to bucket records by region.

Through Jentic, search for 'geocode an address', load GET /json, and execute it with q='Brandenburger Tor Berlin' to return lat, lng, and country code.

Key Endpoints

3 endpoints — opencage geocoder is a worldwide forward and reverse geocoding api built on open data sources including openstreetmap, natural earth, and government-published gazetteers.

METHOD

PATH

DESCRIPTION

GET

/json

Forward or reverse geocode and return JSON

GET

/xml

Forward or reverse geocode and return XML

GET

/geojson

Forward or reverse geocode and return GeoJSON

GET

/json

Forward or reverse geocode and return JSON

GET

/xml

Forward or reverse geocode and return XML

GET

/geojson

Forward or reverse geocode and return GeoJSON

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The OpenCage API key is stored encrypted in the Jentic MAXsystem vault and injected into the 'key' query parameter at request time. Agents receive only operation access — the raw key never enters prompt context or logs.

Intent-based discovery

Agents search by intent (e.g., 'geocode an address' or 'reverse geocode coordinates') and Jentic returns the matching /json, /xml, or /geojson operation with the q parameter schema, so the agent can shape requests without reading the OpenCage docs.

Time to first call

Direct OpenCage integration: 1-2 hours for HTTP client, key handling, and response parsing. Through Jentic: under 10 minutes — search, load schema, execute.

FAQs

Specific to using OpenCage Geocoder API through Jentic.

What authentication does the OpenCage Geocoder use?

The API uses an API key passed as the key query parameter on every request — the spec defines this as the ApiKeyAuth security scheme with location 'query'. Through Jentic, the key is stored encrypted in the MAXsystem vault and injected into the URL at execution time, so the agent never sees the raw key value.

Can I reverse geocode a latitude and longitude with this API?

Yes. Pass the coordinates as a comma-separated string in the q parameter (for example q=51.5074,-0.1278) on /json, /xml, or /geojson. OpenCage returns a formatted address, structured components, and an annotations block with extras such as timezone and what3words tokens.

What are the rate limits for the OpenCage Geocoder?

Free trial accounts are capped at one request per second and 2,500 requests per day, with the remaining quota reported in the response 'rate' element and X-Ratelimit headers. Paid subscription tiers remove the daily cap and the rate element is omitted from those responses, as called out in the spec description.

How do I geocode an address through Jentic?

Search Jentic for 'geocode an address', load GET /json, and execute it with q set to the address string. Jentic injects the API key from MAXsystem and returns the parsed response, so an agent can extract results[0].geometry.lat and results[0].geometry.lng without writing HTTP client code.

Is the OpenCage Geocoder free?

OpenCage offers a free trial tier of 2,500 requests per day at 1 request per second, suitable for development and small-scale apps. Production volumes require a paid subscription — pricing scales with daily request volume and is published on opencagedata.com.

Does OpenCage support GeoJSON output for map libraries?

Yes. The dedicated /geojson endpoint returns a GeoJSON FeatureCollection with the same geocoding payload, which can be passed directly to Leaflet's L.geoJSON or Mapbox GL JS source definitions without an intermediate conversion step.