Clean Maps
← Back to the link cleaner

FOR DEVELOPERS

Clean Maps API docs

A free, no-account HTTP API that cleans Google Maps links. Methods, responses, errors, versioning and curl examples.

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.

Between tabs? Have a coffee.

Two small projects from the same maker.