OpenCage Geocoding API

Forward and reverse geocoding API built on OpenStreetMap and other open data sources, returning structured location data in JSON, XML, or GeoJSON across 40+ languages worldwide.

Evaluated Mar 06, 2026 (0d ago) vcurrent
Homepage ↗ Repo ↗ Other geocoding geolocation openstreetmap rest-api api-key location reverse-geocoding
⚙ Agent Friendliness
64
/ 100
Can an agent use this?
🔒 Security
66
/ 100
Is it safe for agents?
⚡ Reliability
79
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
0
Documentation
88
Error Messages
82
Auth Simplicity
82
Rate Limits
85

🔒 Security

TLS Enforcement
100
Auth Strength
65
Scope Granularity
30
Dep. Hygiene
75
Secret Handling
60

HTTPS enforced. API key as query parameter is a weaker pattern than Authorization header but industry-standard for geocoding APIs. No scope granularity. GDPR-compliant; EU data residency option available. Rate limit headers support compliant agent throttling.

⚡ Reliability

Uptime/SLA
75
Version Stability
82
Breaking Changes
80
Error Recovery
78
AF Security Reliability

Best When

An agent needs reliable worldwide geocoding without Google Maps pricing, especially for moderate-volume use cases where OpenStreetMap data quality is sufficient.

Avoid When

You need sub-meter precision in rural areas, real-time routing, or are processing millions of addresses per day at low cost.

Use Cases

  • Converting an address string into latitude/longitude coordinates for downstream mapping
  • Reverse geocoding GPS coordinates to human-readable addresses or place names
  • Resolving ambiguous location strings with confidence scores and bounding boxes
  • Enriching user-submitted location data with structured components (city, country, postal code)
  • Providing location context to agents handling logistics, delivery, or field service workflows

Not For

  • Real-time traffic routing or turn-by-turn navigation
  • High-volume production workloads on the free tier (2,500 req/day limit)
  • Place search or points-of-interest discovery (use a dedicated POI API)
  • Geocoding at Google Maps accuracy in data-sparse regions where OSM coverage is thin

Interface

REST API
Yes
GraphQL
No
gRPC
No
MCP Server
No
SDK
No
Webhooks
No

Authentication

Methods: api_key
OAuth: No Scopes: No

API key passed as query parameter (key=...). Keys are tied to usage tier. Self-service signup with free tier. No scopes — single key grants full access to the API.

Pricing

Model: freemium
Free tier: Yes
Requires CC: No

Free tier is generous for development and low-volume agents. Paid tiers scale reasonably. No per-request billing — monthly subscription with daily quota. Credit card not required for free tier.

Agent Metadata

Pagination
none
Idempotent
Full
Retry Guidance
Documented

Known Gotchas

  • Free tier rate limit is 1 request/second — agents must throttle or face 429 errors
  • API key in query parameter can appear in server-side access logs; prefer server-side proxy in multi-tenant deployments
  • Results array may contain multiple candidates; agents should inspect confidence score (0-10) to select best match
  • The 'no_annotations' and 'no_dedupe' parameters can reduce response size and latency for high-throughput agents
  • Daily quota resets at midnight UTC — agents near quota limit should handle 402 gracefully and defer non-urgent geocoding

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for OpenCage Geocoding API.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-06.

5909
Packages Evaluated
26151
Need Evaluation
173
Need Re-evaluation
Community Powered