Skip to content


Switch branches/tags
This branch is 34 commits ahead, 1 commit behind samirahmed:master.


Failed to load latest commit information.
Latest commit message
Commit time

Zippopotamus Cloud

New Management has been taken over and re-launched.

For now, the primary concern was getting it back up on stable hosting.

I look forward to adding some features including caching and variable nearby query distances, etc in the near future.

I'm very grateful to Samir and Jeff for cooperating in this transition, and their original work for this project.

Please dont hesitate to contact me with any questions, comments, or concerns. You can file an issue on this repository, or you may email me at


Trea Hauet

This is a repository for Zippopotamus the global postal code API

If you want to contribute to the improving the site, back-end, front-end etc. Just fork away and submit pull requests.

Sample Implementations

Checkout the static/ folder to see some of the sample implementations of Zippopotamus for inspiration and examples for how to implement Zippopotamus API for use in your website etc.

If you want to share an implementation, we would love to post example cases of Zippopotamus on our homepage.

Response Format

On May 1st Zippopotamus changed their JSON response format to work better with international postal codes. Now we support a one-to-many format service. That is that one zip code may map to many regions, this is common in countries like Spain and France (but not in the US and Germany).

Postal Code Information

For now, I'm looking at the best possible way to collaborate on any additional postal code information. Information coming soon.

Technical Information

What is Zippopotamus built on

At the moment the zippopotamus is built on Python, MongoDB and framework.

Local Testing?

The site is configured to run on Apache mod_wsgi, if you want to test out the web interface you can change the file to include the last commented line, which is used to run the site on your local host.

Suggestions and Comments?

Open an issue if you have any questions, comments, or concerns.


Free, open-source postal code and ZIP code lookup API






No releases published


No packages published


  • CSS 60.0%
  • JavaScript 36.0%
  • Python 4.0%