Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

www.Zippopotam.us - Site and API built with MongoDB, Python hosted on dotCloud

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 .dotcloud
Octocat-spinner-32 views
Octocat-spinner-32 .gitignore
Octocat-spinner-32 README.md
Octocat-spinner-32 dotcloud.yml
Octocat-spinner-32 requirements.txt
Octocat-spinner-32 wsgi.py
README.md

Zippopotamus Cloud


API Moved

Our full crowd-source zip-db can be found here

Trea has taken over Zippopotamus - you can find it at the ekotechnology fork

Thanks

Jeff & Samir


This is a repository for Zippopotamus the global postal code API

Zippopotamus is hosted by dotCloud. This repo is used to build and maintain the site.

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 information our postal codes and countries supported, you should check out the zippopotamus crowd-sourcing project. Here you can download the entire database dump, or fork and add changes that we will incorporate into our DB.

Technical Information

What is Zippopotamus built on

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

Local Testing?

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

Suggestions and Comments?

Hate it? Love it? Open an issue if you have a problem or contact Jeff Crowell or Samir Ahmed

Also, we aren't bottle or python or mongo experts. So if you see a way that we can improve, please let us know. Additionally, if you have examples (translation corrects etc) of using Zippopotamus that you want to share let us know and we can feature your site / blog on the homepage.

Something went wrong with that request. Please try again.