Introduction

The ZIP Code Master API provides you with detailed profile and demographic data for each ZIP code in the United States. This simple API has two resource endpoints to retrieve a brief summary or detailed data set for each ZIP code. Responses are in JSON format.

Pricing Plans and Usage

Basic - This plan is suited for developers who want to try out the API for building apps or websites.
Pro - This plan is suited for small, personal apps or websites for occasional use.
Ultra - This plan provides more daily requests and well is suited for heavier commercial usage.
Mega - Enjoy unlimited requests for all endpoints. Best for enterprise usage.

Endpoints (all endpoints are GET methods)

/summary/99999 -> returns summary profile for the provided ZIP code
/detail/99999 -> returns detailed profile and demographic data for the provided ZIP code

Sample Response (Summary)

{
    "zip_code": "90210",
    "name": "Beverly Hills",
    "type": "Non-Unique",
    "county": "Los Angeles",
    "state": "California",
    "area_codes": "310,424 ",
    "population": "21741",
    "racial_majority": " 82.35%",
    "public_school_racial_majority": "White 81.4%",
    "unemployment_rate": "5.5%",
    "median_household_income": "$149195",
    "avg_adjusted_gross_income": "$768940",
    "school_test_performance": "", (deprecated)
    "avg_commute_time": "", (deprecated)
    "time_zone": "Pacific Daylight Time",
    "elevation_range": "", (deprecated)
    "area": "11 Sqm.",
    "coordinates": "34.10228500, -118.41467300"
}

Sample Response (Detail)

{
    "summary": {
        "zip_code": "10001",
        "name": "New York",
        "type": "Non-Unique",
        "county": "New York",
        "state": "New York",
        "area_codes": "212,646,917 ",
        "population": "21102",
        "racial_majority": "White 51.83%",
        "public_school_racial_majority": "White 30%",
        "unemployment_rate": "6.6%",
        "median_household_income": "$63014",
        "avg_adjusted_gross_income": "$179970",
        "school_test_performance": "", (deprecated)
        "avg_commute_time": "", (deprecated)
        "time_zone": "Eastern Daylight Time",
        "elevation_range": "", (deprecated)
        "area": "1 Sqm.",
        "coordinates": "40.75024500, -73.99701900"
    },
    "population": {}, (deprecated)
    "ethnicity": {
        "White": "11799,51.83%",
        "Black Or African American": "2454,10.78%",
        "Hispanic": "3764,16.53%",
        "American Indian Or Alaskan Native": "97,0.43%",
        "Asian": "4085,17.94%",
        "Native Hawaiian & Other Pacific Islander": "0,0%",
        "Other Race": "95,0.06%",
        "Two Or More Races": "496,2.43%"
    },
    "school_ethnicity": {
        "White": "30%",
        "Black Or African American": "14.3%",
        "Hispanic": "28.9%",
        "Asian": "22.1%",
        "Hawaii/Pacific Islander": "0%",
        "American Indian Or Alaskan Native": "0.9%",
        "Two or More Races": "3.8%"
    },
    "school": {}, (deprecated)
    "income": {}, (deprecated)
    "real_estate": {}, (deprecated)
    "employment": {}, (deprecated)
    "cities": [
        "New York, NY"
    ],
    "adjacent_zip_codes": [
        "10014 - New York",
        "10010 - New York",
        "10017 - New York",
        "10018 - New York",
        "10003 - New York",
        "10011 - New York",
        "10036 - New York",
        "10019 - New York",
        "10016 - New York"
    ],
    "gardening": {}, (deprecated)
    "climate": {}, (deprecated)
    "cbsa": {}, (deprecated)
    "time_zone": {
        "Time Zone": "Eastern Daylight Time",
        "IANA Time Zone": "America/New_York",
        "Follows DST": "", (deprecated)
        "GMT Difference": "" (deprecated)
    }
}

Errors

400 - Invalid Request (you have specified an invalid resource or not supplied appropriate path parameters)
401 - Unauthorized (you are not authorized to use the specified endpoint)
404 - Value Not Found (the ZIP code provided could not be found)

Updates

25 MAR 2023 - Due to changes in data availability, the API broke on 21 MAR 2023. We’ve implemented updates to correct the major issues, but several fields had to be deprecated (see sample responses above). The fields will remain in the response so client apps don’t break, but they will be blank going foward.

Please Note

All response data is provided in string format for easy and consistent usage.
Field order in response is not guaranteed or preserved.
In order to make our API data ever-evolving, new fields could be added at any time.

Thank you

We strive to provide the most up-to-date data available. If for any reason you notice data discrepancies, please contact us immediately so we can resolve them.