Quickstart Guide

Step 1: Choose a Plan to Get Started:

We have 3 plans to get started. Each plan offers Zip Code and Geographic data in multiple views. If you can't decide which to use, we have a limited free Zip Code API plan which is suitable for most basic lookups.

Choose a plan

Step 2: Write Some Code:

Yeah, it's that simple to use our Zip Code API. Below are some basic code examples:

JavaScript Example (Using jQuery):

function logResults(json){
  console.log(json);
}

$.ajax({
  url: "https://zipfeeder.us/api/v2/zipcode/01950/?key=YOUR_KEY",
  dataType: "jsonp",
  jsonpCallback: "logResults"
});
    

Python Example (Using Requests: HTTP for Humans)

import json

# install requests via pip
import requests


if __name__ == "__main__":

    # this uses requests, you could use urllib2 as well
    try:
        # will return a 403 if key is not valid.
        r = requests.get("https://zipfeeder.us/api/v2/zipcode/02124/?key=YOUR_KEY")

        zip_dict = json.loads(r.text)

        print zip_dict['city']
        print zip_dict['state']

    except Exception as e:

        print "Zip could not be loaded: {}".format(e)
    

PHP Example (Using Guzzle)


//this sample use guzzle, but you could also use cURL
$guzzle = new \GuzzleHttp\Client();

$resp = $guzzle->get("https://zipfeeder.us/api/v2/zipcode/01950/?key=YOUR_KEY");

$zip_data = json_decode($resp->getBody());

echo $zip_data->city.", ".$zip_data->state;