Migration

Migrating from Geocodio

Geocodio built a strong reputation specifically around United States and Canada address accuracy, along with a bulk CSV upload workflow that lets someone geocode a spreadsheet of addresses without writing any integration code at all. Its API key is sent as a query parameter (api_key), and single-address responses come back with a results array containing address_components and an accuracy field describing match confidence.

The bulk CSV workflow is worth treating as its own migration item, separate from any programmatic API calls your application makes. A marketing team or an operations analyst who uploads a spreadsheet through a web form once a month is not touched by changes to your backend code, and that workflow needs its own plan, whether that means scripting a batch job against the new API or handling it manually for a transition period.

For the programmatic side, My Geocode's Geocodio compatibility host reproduces the results array and address_components structure that Geocodio returns, with the copyright, terms, and privacy text being the only content that changes. Reference details are at /compatibility/geocodio/. Code that reads results[0].address_components.city should keep working once the host and key are updated.

Some points worth planning around specifically because of Geocodio's regional focus:

  • If your integration relies on any US-specific append fields, such as congressional district information, check whether that data point is part of your migration scope or whether it needs a separate lookup going forward
  • Confirm whether any bulk jobs run against a rate limit tuned specifically to Geocodio's documented limits, since retry timing built around one provider's numbers does not necessarily fit another's
  • Test a batch of real historical addresses from your own data against the new host before assuming full parity, particularly for edge cases like PO boxes or rural route addresses

Authentication supports an X-API-Key header, an Authorization: Bearer header, HTTP Basic auth, or a query parameter, so whichever style your existing Geocodio client uses for its api_key parameter has an equivalent here.

On cost, there is no separate bulk pricing tier to think about: every endpoint, including this compatibility host, is priced the same, with 2,500 free requests a day requiring no key at all, another 2,500 free per key per day counted per network, and beyond that prepaid credit at €0.0001 per request or an Unlimited key at €50 a month. A large one-time bulk job and a steady trickle of API calls cost the same per request either way, which makes estimating a bulk migration's cost a straightforward multiplication rather than a tier lookup.