Free, no account, no key
Every endpoint is open: no sign-up, key or token. There is no application rate limit and no rate-limit headers. Please cache what you reuse.
Clean a link
GET /api/v1/clean?url= takes a URL-encoded Google Maps link, including HTTPS short links. /api/clean is a compatibility alias with the same behaviour.
curl -G https://cleanmaps-link.pages.dev/api/v1/clean \
--data-urlencode "url=https://www.google.com/maps/place/Sydney+Opera+House/@-33.8567844,151.2152967,17z/data=!4m6!3m5!1s0x6b12ae665e892fdd:0x3133f8d75a1ac251!8m2!3d-33.8567844!4d151.2152967"
A successful response is JSON with the cleaned link in clean, a kind of place, search or fallback, a short note, and verified, which is always null. That means the service has not checked where the link lands. Treat it as unverified, never as success.
Expand a short link
GET /api/expand?url= follows a maps.app.goo.gl or goo.gl/maps link through a bounded number of Google redirects and returns the full URL. It does not open the final Maps page. Private addresses, credentials, odd ports and other hosts are rejected.
Errors
Errors use application/problem+json with type (always about:blank), title, status, detail, error and verified set to null. Bad input is 400. The wrong method is 405 with an Allow header, including on the health check. /api/expand returns the same error shape.
Health
GET /health returns 200 when the application is up. It says nothing about Google.
Versioning
New response fields are additive and stay in v1, so ignore fields you don't know. A breaking change would ship as /api/v2 alongside v1. Nothing is deprecated; Deprecation and Sunset headers will only appear once a date is scheduled.
Machine-readable versions
The same contract is available as OpenAPI and as plain Markdown. For MCP, see the MCP server page. Privacy details are on the privacy page.