# Geocodio (slim)

> Geocodio is a hosted geocoding API from Dotsquare LLC for addresses in the US, Canada, Mexico, the UK, Australia and New Zealand. It does forward, reverse and batch geocoding, distance matrices and census, district and timezone data appends.

- Full: https://www.anchorterminal.com/tools/geocodio.md (~7,100 tokens) · this version ~1,680 tokens · JSON https://www.anchorterminal.com/tools/geocodio.json · canonical https://www.anchorterminal.com/tools/geocodio
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · MCP: https://www.anchorterminal.com/mcp · Updated: 2026-11-07 · pricing https://www.anchorterminal.com/tools/geocodio#pricing · reviews https://www.anchorterminal.com/tools/geocodio#reviews
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)

**BB · 72.2/100 · rank #137 of 1486 · #4 in Maps, geocoding & places · agent-ready · confidence high**


Assessment: Geocodio publishes llms.txt, an AGENTS.md on cost and retries, an OpenAPI spec and a dated changelog, and its results may be stored permanently. Coverage stops at six countries, there's no MCP server or published SLA for self-serve plans, and the docs still put the key in the query string by default.

## Facts

- Kind: HTTP API · vendor: Dotsquare LLC · category: Maps, geocoding & places · legal entity: Dotsquare LLC · provenance 93/100
- Local only (HTTP): pypi `geocodio-library-python`, npm `geocodio-library-node`
- Auth: API key · pricing: Freemium · x402: no · licence: unknown
- Benchmark probes: not run yet, so Performance is pending
- Vendor status page: no problems reported, All Systems Operational (2026-11-07 18:21 UTC)
- Surface listed: The REST API at api.geocod.io/v2.1, read from www.geocod.io/docs, llms.txt, AGENTS.md, the OpenAPI spec, the pricing, terms, privacy and security pages, status.geocod.io and the Geocodio GitHub repositories on 6 November 2026. No account was made and no key was used
- Coverage: Forward and reverse geocoding and distance for the US, Canada, Mexico, the UK, Australia and New Zealand. No other countries
- Endpoints: /geocode and /reverse (single GET or batch POST up to 10,000 lookups), /parse, /distance, /distance-matrix (10,000 calculations), /distance-jobs (50,000), /lists for spreadsheets up to 10 million lookups, and a Google Maps compatible /maps/api/geocode/json
- Data appends: Congressional and state legislative districts with legislators, census geographies and ACS data, school districts, ZIP+4, FFIEC, Canadian ridings, UK constituencies and census, Australian census and electorates, and timezone, each billed as one more lookup
- Rate limits: 1,000 requests a minute on single GET /geocode and /reverse on pay-as-you-go and Flex, 100 a minute on Enterprise Flex. Batch and lists aren't limited by these numbers. 429 with X-RateLimit headers
- Errors: 403 bad key, missing permission or daily limit reached, 422 bad input, 429 rate limited, 500 server error, with a retry rule for each in llms.txt
- Data retention: API and spreadsheet input and results deleted within 45 days, Lists API data after 72 hours, error logs 90 days. The privacy policy says customer data isn't used to train AI models
- Hosting: Self-serve is hosted in Europe. Enterprise runs on separate infrastructure with SOC 2 Type II, HIPAA, SAML SSO, US hosting and on-premises options
- SDKs: Python 1.6.0 (12 October 2026), Node 2.3.0 (12 October 2026), PHP 3.4.1 (4 November 2026) and a Ruby gem, plus a Go CLI, all MIT
- Legal entity: Dotsquare LLC, dba Geocodio, Norfolk, Virginia, under Virginia law
- Prices: Lookup after the free tier, pay-as-you-go $1 per 1,000 requests; Flex 350 plan $315 per month (plan); Unlimited Geocoding plan $1600 per month (plan)

- Scores: Reliability 70, Performance pending, Schema & documentation 92, Agent ergonomics 80, Security & auth 58, Payments & pricing 40, Task success pending, Maintenance & community 86, Transparency & trust 87 · total over the 7 assessed categories
- Why: Reliability, Hosted lines. · Schema & documentation, OpenAPI 3.0.1 spec, version 2.1.0, with 11 paths (25). · Agent ergonomics, API reading. · Security & auth, Revocable keys, five on pay-as-you-go, each with permissions (Lists and Distance off by default), which earns 25. Less 10 because the docs s… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, API v2.1 released 3 November 2026 (Australia and New Zealand), and PHP library 3.4.1 on 4 November (30). · Transparency & trust, Editorial half only.
- Sources: 13, open questions: 4, both in the full twin
- Capabilities: geo.geocode, geo.reverse, geo.routing
- JSON: https://www.anchorterminal.com/api/v1/tools/geocodio.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/geocodio.svg` or a link to https://www.anchorterminal.com/tools/geocodio from a page on geocod.io or one of its subdomains, or the README at the root of github.com/Geocodio/geocodio-cli, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.
- Support: support@geocod.io; https://www.geocod.io/contact; https://www.geocod.io/guides/; more in the full twin

## Before you call it

1. Always set `country`, because an address with none falls back to the US and is billed even when it's wrong
2. Send the key as `Authorization: Bearer`, not in the query string, so it stays out of logs
3. Use batch POST /geocode (up to 10,000 lookups) or the Lists API rather than looping single requests
4. Treat accuracy_type place, county or state as not found, and check `_warnings` for appends that were billed but skipped
5. Don't retry 403 or 422. On 429 read X-RateLimit headers and back off, and never re-upload a list sitting in ENQUEUED

## Connect

```bash
pip install geocodio-library-python
```

```bash
curl -H "Authorization: Bearer $GEOCODIO_API_KEY" "https://api.geocod.io/v2.1/geocode?q=1109+N+Highland+St,+Arlington+VA&country=USA"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/geocodio

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Mapbox APIs + MCP | BB | 77.2 | geo.geocode, geo.reverse, geo.routing | https://www.anchorterminal.com/tools/mapbox.min.md |
| Amazon Location Service | BB | 76.5 | geo.geocode, geo.reverse, geo.routing | https://www.anchorterminal.com/tools/amazon-location.min.md |
| Google Maps Platform + Grounding Lite MCP | BB | 75.4 | geo.geocode, geo.reverse, geo.routing | https://www.anchorterminal.com/tools/google-maps-platform.min.md |
| Azure Maps | B | 67.1 | geo.geocode, geo.reverse, geo.routing | https://www.anchorterminal.com/tools/azure-maps.min.md |
| ArcGIS Location Platform | B | 66.1 | geo.geocode, geo.reverse, geo.routing | https://www.anchorterminal.com/tools/arcgis.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)