Skip to content

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

Notifications You must be signed in to change notification settings

krushmoto/zippopotamus

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

77 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zippopotamus Cloud


New Management

Zippopotam.us 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 [email protected].

Thanks,

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 bottle.py 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 wsgi.py 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.

About

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

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