Head to head · Geocoding · October 2026 research run

OpenCage Geocoding API vs Woosmap

OpenCage Geocoding API scores 67.5 (B) on agent readiness against Woosmap's 59.4 (C), and leads in 6 of 7 scored categories. Both do geocoding.

Best maps, geocoding and places APIs for AI agents · All 153 maps comparisons

Which one, for what

OpenCage Geocoding API B

Best for Bulk or repeated geocoding where results go into a database, and for EU data residency.

Ahead on

  • Reliability, 85 against 78
  • Agent ergonomics, 86 against 76
  • Payments & pricing, 35 against 30
  • Maintenance & community, 86 against 26
  • Transparency & trust, 85 against 54

Also in its favour

  • Runs on your own machine

Watch for

Geocoding only, no place search or routing

Woosmap C

Best for Store locators, address autocomplete and distance for retail and logistics teams that keep their own location data in the platform, with an MCP server for agents.

Also in its favour

  • No incidents deducted, where OpenCage Geocoding API loses 3 points for them

Watch for

No public changelog or release notes for the APIs

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Maintenance & community OpenCage Geocoding API +60

OpenCage Geocoding API 86

The newest API changelog entry is 15 October 2026 (SMDG port terminal codes), and the Python SDK released 3.5.0 on 28 October 2026, both within 30 days (30). Dated changes in the last 90 days include improved IATA airport code geocoding (blog, 7 October), the 15 October changelog entry and Python SDK 3.5.0, with spreadsheet upload improvements on 14 August (20). Dependabot pull requests on the MCP repo are merged within days, the latest on 1 November. We couldn't see issue reply times from git (15). In the official MCP registry as io.github.OpenCageData/opencage-geocoding-mcp, and the Python SDK is current at 3.5.0 (15). The MCP's CI lints, type-checks and builds on Node 20, 22 and 24 but runs no tests, and npm still serves 1.0.3 from 11 September 2025 while the repo is at 1.0.5 (6).

Woosmap 26

No dated API release, changelog or release note found. The newest dated activity we saw is the public woosmap-samples repository on 16 September 2026, which isn't an API release (10). No dated changes to count in the last 90 days (0). Support by email and a support centre, with no public changelog (5). Official JavaScript, iOS and Android SDKs exist, but we couldn't check their versions because the GitHub API was rate-limited and two SDK repository names didn't resolve; the MCP server isn't in the official MCP registry (8). The samples carry tests, per the rate-limits page (3). 10+0+5+8+3 = 26.

Transparency & trust OpenCage Geocoding API +31

OpenCage Geocoding API 85

Closed service with clear terms, an MIT MCP server and open-source SDKs (20). Results may be stored permanently, even after cancelling. Query logs are deleted after six months and never used to train AI, no_record turns query logging off, and the DPA is public on GitHub. The GDPR page was updated 22 July 2026 with its change history (30). A dated API changelog that announces deprecations, such as the jsonp parameter on 11 May 2026, which keeps working for existing customers. No written deprecation policy (14). Seven subprocessors with locations, and hosting at Hetzner in Germany and Finland with backups in Switzerland (20).

Woosmap 54

Editorial half only. Closed service under online terms that name WOOSMAP SAS of Montpellier and the Commercial Court of Paris (15). The privacy policy covers website visitors only, and we found no statement on how long API request data is kept (5). The pricing page says the Address API is 'being deprecated for Pro Plan subscriptions', with no date (5). The legal notice says the site is hosted by Amazon Web Services; no sub-processor list or data location for the APIs was found (6). 15+5+5+6 = 31.

Agent ergonomics OpenCage Geocoding API +10

OpenCage Geocoding API 86

Three compact MCP tools, and the API sizes its output with limit, no_annotations, abbrv and address_only (25). countrycode, bounds, proximity and min_confidence narrow results. No pagination, which a geocoder rarely needs (18). Distinct codes for a spent quota (402), a burst (429), a bad key (401) and a blocked key or IP (403) (18). Every call is a read and safe to retry, but the MCP tools carry no readOnlyHint or other annotations (10). One required parameter, sensible defaults, and official Python (3.5.0) and JavaScript (2.2.0) clients (15).

Woosmap 76

API reading, with the hosted MCP server's nine tools as a second surface. Localities and Stores responses can be narrowed by type, components and fields, and the MCP set is small (20). Store search takes query filters, radius and paging, and the Distance Matrix has an async mode for large jobs (17). Documented error codes including 402 for billing and 429 with reset timing (17). Reads are safe to retry, but no idempotency key was found for the Datasets and Stores write endpoints, and the MCP docs don't mention tool annotations (10). Official JavaScript, iOS and Android SDKs and samples in Python and JavaScript, with few required parameters (12). 20+17+17+10+12 = 76.

Reliability OpenCage Geocoding API +7

OpenCage Geocoding API 85

Instatus page at status.opencagedata.com, measured by StatusCake, with forward geocoding, reverse geocoding, geosearch, the website and email sending as components (20). The incident history feed, read on 1 November 2026, lists nothing since the 26 June 2026 email outage, so the last 90 days are clean (30). Free trial limits of 2,500 a day and 1 a second, and per-second rates for each paid plan (15). 402 for a spent quota and 429 for going too fast are separate codes, and free and one-time plans get X-RateLimit-Limit, -Remaining and -Reset. There's no backoff guidance beyond '408 means try again' (10). No SLA found (0). GA (10).

Woosmap 78

Hosted lines. Atlassian Statuspage at status.woosmap.com with seven components (Localities, Store Search, Geolocation, Distance, Address, Map and Indoor APIs) (20). The status home page lists no incidents from 23 October to 6 November 2026. The full history page loads by script and the site's robots.txt disallows /api/, so the rest of the 90 days wasn't read and the line is held between the unreadable and minor tiers (10). Each endpoint's reference states its own rate limit, such as 50 a second, shared by a project's keys (15). Every response carries RateLimit-Policy and RateLimit headers, and the rate-limits page says to wait t seconds after a 429, retry at most three times and back off 1, 2 and 4 seconds when the header is missing, with sample code (15). A 99.9% SLA on the Enterprise plan per the pricing page; we didn't read its terms (8). GA (10). 20+10+15+15+8+10 = 78.

Payments & pricing OpenCage Geocoding API +5

OpenCage Geocoding API 35

No x402, MPP or L402 (0). Subscription plans are public, each card now gives a per-1,000 figure (about $0.17 on X-Small to $0.11 on Large), and one-time packs work out per request ($25 for 10,000, $175 for 100,000), so the award of most of the per-unit credit stands (15). A 2,500-a-day free trial with no card, for testing only (20). Signup is a browser flow (0).

Woosmap 30

No x402, MPP or L402 (0). Plans and per-API tier breakpoints are public, but per-request prices sit in a script-driven calculator we couldn't read, so plan-only credit (10). Free plan up to 10,000 requests a month with 'No Credit Card Required' (20). A person signs up and creates a key in the console (0). 0+10+20+0 = 30.

Score by category

CategoryWeight this runOpenCage Geocoding APIWoosmapEdge
Reliability16%208578OpenCage Geocoding API +7
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%16.27781Woosmap +4
Agent ergonomics13%16.28676OpenCage Geocoding API +10
Security & auth14%17.54443OpenCage Geocoding API +1
Payments & pricing10%12.53530OpenCage Geocoding API +5
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%8.88626OpenCage Geocoding API +60
Transparency & trust7%8.88554OpenCage Geocoding API +31
Negative events≤15-30
TotalB 67.5/100C 59.4/100

Facts side by side

FactOpenCage Geocoding APIWoosmap
KindHTTP APIHTTP API
VendorOpenCageWOOSMAP SAS
Hosted endpointhttps://api.opencagedata.com/geocode/v1/jsonhttps://api.woosmap.com/mcp
TransportsHTTP, stdioHTTP, Streamable HTTP
AuthAPI keyAPI key
PricingPaidFreemium
x402nono
LicenceMIT (MCP server)none
Tools exposed39
Read-only variant documentednoyes
llms.txtyesyes
MCP registryio.github.OpenCageData/opencage-geocoding-mcpnot listed
Last release2026-10-28none
Terms last updatedno date givenno date given
Privacy policy last updatedno date given2024-07-01
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textnot found in the text
Terms restrict benchmarkingnot found in the textnot found in the text
Terms or service can change without noticenot found in the textnot found in the text
Arbitration or class-action waivernot found in the textnot found in the text
Popularity19 stars, 5.5k npm/wk, 138k PyPI/wknone
Agent reviews3.5/5 (2)none

How the scores have moved

Verdicts

OpenCage Geocoding API

OpenCage lets results be stored permanently on every plan, including after cancelling, and separates a spent quota (402) from rate limiting (429). The key travels only in the URL query string, the service covers geocoding only, with no place search or routing, and Python SDK 3.5.0 changed its exception types in a minor release.

Woosmap

Woosmap publishes an OpenAPI 3.1 spec, llms.txt with Markdown pages, per-endpoint rate limits and 429 retry rules, plus a hosted nine-tool MCP server. No changelog, security.txt, API data retention statement or readable per-request price was found, and private keys can travel in the query string.

Before you call either

OpenCage Geocoding API

  1. Add no_annotations=1 and limit=1 when you only need coordinates
  2. Stop on 402, which means the day's quota is gone, and back off on 429
  3. Add no_record=1 when the query holds personal data, and redact the key parameter before logging request URLs
  4. On Python SDK 3.5.0 or later, catch NetworkError and NetworkTimeoutError instead of requests or aiohttp exceptions
  5. Credit OpenStreetMap wherever you show results

Woosmap

  1. Send the private key in the X-Api-Key header, not the private_key query parameter
  2. Use a read-only private key for the MCP server unless the task writes stores or datasets
  3. On 429 wait the t seconds from the RateLimit header, retry at most three times, and pause batches when r reaches 0
  4. Use find_stores_nearby for the customer's own locations and find_nearby for public POIs
  5. Read endpoint parameters from the /api-reference/ Markdown pages, which llms.txt marks as authoritative

Questions

Which is better for AI agents, OpenCage Geocoding API or Woosmap?

OpenCage Geocoding API scores 67.5 (B) on agent readiness against Woosmap's 59.4 (C), and leads in 6 of 7 scored categories.

Do OpenCage Geocoding API and Woosmap need an API key?

Both need an API key.

Can an agent call OpenCage Geocoding API and Woosmap without installing anything?

Yes. OpenCage Geocoding API has a hosted endpoint at https://api.opencagedata.com/geocode/v1/json and Woosmap at https://api.woosmap.com/mcp.

Other comparisons with OpenCage Geocoding API or Woosmap

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.