Ziptastic!

Thomas Schultz, May 08, 2012

Ziptastic! - We added more countries!

So since we released Ziptastic a few weeks ago we’ve had a lot of requests to support additional countries (especially Canada).

We now support these country codes: AD, AR, AS, AT, AU, BD, BE, BG, BR, CA, CH, CZ, DE, DK, DO, ES, FI, FO, FR, GB, GF, GG, GL, GP, GT, GU, GY, HR, HU, IM, IN, IS, IT, JE, JP, LI, LK, LT, LU, MC, MD, MH, MK, MP, MQ, MX, MY, NL, NO, NZ, PH, PK, PL, PM, PR, PT, RE, RU, SE, SI, SJ, SK, SM, TH, TR, US, VA, VI, YT, ZA

I’m not sure of the accuracy of this database, but I think it should get fairly close.

When making this addition we realized that we would need the country code as a variable in order to return the correct information for a user’s postal code.

We know of quite a few sites using Ziptastic’s free API and we didn’t want to break them, so we decided to version the API with a /v2/ prefix.

Currently the API is totally backwards compatible with the following APIs:

Version 1 APIs

http://zip.elevenbasetwo.com/?zip=48867
http://zip.elevenbasetwo.com/48867

Version 2 APIs

http://zip.elevenbasetwo.com/v2/US/48867

We recommend using GeoIP to help determine a user’s country. Maxmind.com has a really good country database that they offer for free. I have a blog post about how to use it.