Input | |||

field name | optional | example | |

Longitude and Latitude * | one * field required | longitude=-80.191741&latitude=26.322114 | |

IP Address * | one * field required | ipaddress=65.34.220.39 | |

ZipCode * | one * field required | zipcode=33444 | |

RadiusMiles | optional (max value is 20) | radiusMiles=5 | |

MedianAgeLow | optional | medianAgeLow=32 | |

MedianAgeHigh | optional | medianAgeHigh=36 | |

IncludeCrimeData | optional (true) | includecrimedata=true | |

$format | optional (json) xml is default | $format=json | |

* This service suports fixed query. | |||

* The required parameters support up to 10 records separated by a pipe ("|") delimiter. No radius value is allowed. | |||

Example: zipcode=33444|33703|34990 | |||

Sample REST Calls | |||

By Zip Code Sample | |||

https://azure.geodataservice.net/GeoDataService.svc/GetUSDemographics?includecrimedata=true&zipcode=33444 | |||

By IP Address | |||

https://azure.geodataservice.net/GeoDataService.svc/GetUSDemographics?includecrimedata=true&ipaddress=65.34.220.39 | |||

By Longitude/Latitude | |||

https://azure.geodataservice.net/GeoDataService.svc/GetUSDemographics?longitude=-80.191741&latitude=26.322114 | |||

The unlimited trial web service calls are throttled by 8 seconds. | |||

Data Field Definitions | |||

Location | |||

ZipCode | 5 digit zip code as
designated by the United States Postal Service. U.S. Territories are also included in our data. (Puerto Rico, American Samoa, etc.) |
integer | |

Longitude | The geographic coordinate of a point measured in degrees east or west of the Greenwich (prime) meridian. | double | |

Latitude | The geographic coordinate of a point measured in degrees north or south of the equator. | double | |

Terrain | |||

ElevationAverageFeet | The county's average elevation. | integer | |

LandArea | Show the approximate amount of land area covered by this ZIP Code in Square Miles | integer | |

WaterArea | Show the approximate amount of water area covered by this ZIP Code in Square Miles | integer | |

Household Averages - Census 2010 | |||

HouseholdsPerZipCode | Total estimated amount of households per ZIP Code | decimal | |

PersonsPerHousehold | Average number of individuals per household.The average number of individuals per household are not projected to the future. | decimal | |

AverageHouseValue | The average house value per ZIP code | decimal | |

IncomePerHousehold | The average household income per ZIP code | decimal | |

IncomeBelowPoverty | Percentage of population who are considered poverty | decimal | |

IncomeLessThan25 | Percentage of population who make less than 25K annually | decimal | |

IncomeBetween25to50 | Percentage of population who make less than 25K to 50K annually | decimal | |

IncomeBetween50to100 | Percentage of population who make less than 50K to 100K annually | decimal | |

IncomeBetween100to200 | Percentage of population who make less than 100K to 200K annually | decimal | |

IncomeGreater200 | Percentage of population who make 200K plus annually | decimal | |

Education A36(Census 2010) | |||

EducationHighSchoolGraduate | Percentage of population which have graduated from high school or GED | decimal | |

EducationBachelorOrGreater | Percentage of population which have a BS/BA (4 year program) | decimal | |

Region | |||

StateAbbreviation | U.S. two digit state code. Sort on this field to get all your data grouped by state. | string | |

State | The full U.S. state name. | string | |

CityAbbreviation | Abbreviation of city alias where applicable. | string | |

AreaCode | Telephone area code(s) of the particular postal zone (zip code). Sorting by this field will give you all the data grouped by area code. | string | |

City | City name as designated by the United States Postal Service. | string | |

County | The county the zipcode is in | string | |

TimeZone | Time zone designation within the U.S. - the numbers
4-15 are assigned to the time zones 4 = Atlantic (GMT -04:00) 5 = Eastern (GMT -05:00) 6 = Central (GMT -06:00) 7 = Mountain (GMT -07:00) 8 = Pacific (GMT -08:00) 9 = Alaska (GMT -09:00) 10 = Hawaii-Aleutian Islands (GMT -10:00) 11 = American Samoa (GMT -11:00) 14 = Guam (GMT +10:00) 15 = Palau (GMT +9:00) |
integer | |

IsDayLightSaving | Flag indicating whether a ZIP Code observes daylight savings. | boolean | |

IsZipCodeMultiCounty | Flag indicating whether this ZIP Code crosses county lines | boolean | |

USRegion | A geographic area consisting of several States defined by the U.S. Department of Commerce, Bureau of the Census. The States are grouped into four regions and nine divisions. Regions include: West, South, Midwest, and Northeast | string | |

USDivision | A geographic area consisting of several States defined by the U.S. Department of Commerce, Bureau of the Census. The States are grouped into four regions and nine divisions. Divisions include: New England, East North Central, East South Central, South Atlantic, Middle Atlantic, Mountain, West North Central, West South Central, and Pacific | string | |

Regions Census 2010 | |||

MSA | Metropolitan Statistical Area. (no longer used by government - CBSA is the new standard) | string | |

MSAName | Metropolitan Statistical Area Description Name. | string | |

PMSA | Primary Metropolitan Statistical Area Code | string | |

PMSAName | Primary Metropolitan Statistical Area Name | string | |

CSA | Core Statistical Area Code | string | |

CSAName | Core Statistical Area Name | string | |

CBSA | Core Based Statistical Area. You can read more on CBSA's here | string | |

CBSAName | The name of the Core Based Statistical Area | string | |

CBSADivision | Core Based Statistical Area Division number | string | |

CBSAStatisticType | Indication of whether a CBSA is Metro (over 50,000 population) or Micro (10,000 - 50,000 population) | string | |

CBSADivisionName | Core Based Statistical Area Division Name | string | |

CountyFIPSCode | Federal Information Processing Standards code given to counties or parishes | string | |

StateFIPSCode | Federal Information Processing Standards code given to each state or US territory | string | |

SFDU | Total count of single family deliveries in this ZIP Code; generally analogous to homes | string | |

MFDU | Total count of multifamily deliveries in this ZIP Code; generally analogous to apartments | string | |

Business Census 2009 | |||

TotalNumberOfBusinesses | The total number of Business Establishments for this ZIP Code. Data taken from Business Census 2009 | integer | |

TotalNumberEmployees | The total number of employees for this ZIP Code. Data taken from Business Census 2009 | integer | |

FirstQuarterPayroll | The total payroll for the frist quarter this ZIP Code. Data taken from Business Census 2009. | decimal | |

AnnualPayroll | The total annual payroll for this ZIP Code. Data taken from Business Census 2009 | decimal | |

Federal 2008 Crime | |||

ViolentCrime | 2008 Federal Crime Statistics | integer | |

MurderAndManslaughter | 2008 Federal Crime Statistics | integer | |

ForcibleRape | 2008 Federal Crime Statistics | integer | |

Robbery | 2008 Federal Crime Statistics | integer | |

AggravatedAssault | 2008 Federal Crime Statistics | integer | |

PropertyCrime | 2008 Federal Crime Statistics | integer | |

Burglary | 2008 Federal Crime Statistics | integer | |

LarcenyTheft | 2008 Federal Crime Statistics | integer | |

MotorVehicleTheft | 2008 Federal Crime Statistics | integer | |

Arson | 2008 Federal Crime Statistics | integer | |

Lifestyle | |||

NearGayVillage | Idenify if the zipcode falls in a gay village | boolean | |

Growth Projections - Census 2010 | |||

GrowthRank | The overall current rank in which this county is growing according to the US Census 2010 | integer | |

GrowthHousingUnits2009 | The 2009 current rank in which this county is growing according to the US Census. | integer | |

GrowthHousingUnits2010 | The 2010 current rank in which this county is growing according to the US Census. | integer | |

GrowthIncreaseNumber | The change in housing units from 2008 to 2010, expressed as a number. Source: Housing Unit Estimates for the 100 Fastest Growing U.S. | integer | |

GrowthIncreasePercentage | The change in housing units from 2008 to 2010, expressed as a percentage. Source: Housing Unit Estimates for the 100 Fastest Growing U.S. | decimal | |

Post Office Delivery | |||

DeliveryResidential | The number of active residential delivery mailboxes and centralized units for this ZIP Code. This excludes PO Boxes and all other contract box types | integer | |

DeliveryBusiness | The number of active business delivery mailboxes and centralized units for this ZIP Code. This excludes PO Boxes and all other contract box types | integer | |

DeliveryTotal | The total number of delivery receptacles for this ZIP Code. This includes curb side mailboxes, centralized units, PO Boxes, NDCBU, and contract boxes. This count is for Residential and Business combined | integer | |

Median Age - Census 2010 | |||

MedianAge | The Median Age for all people per ZIP code | decimal | |

MedianAgeMale | The Median Age for all Males per ZIP code | decimal | |

MedianAgeFemale | The Median Age for all Females per ZIP code | decimal | |

Population - Census 2010 | |||

PopulationEstimate | This field gives the estimated household population for this ZIP Code for May, 2012. The estimate is derived from known delivery information, household occupancy rates, household size, and more to come up with an accurate estimation for the current population | integer | |

Population | The population of the ZIP Code | integer | |

WhitePopulation | The estimate of White population per ZIP code | integer | |

BlackPopulation | The estimate of Black population per ZIP code | integer | |

HispanicPopulation | The estimate of Hispanic population | integer | |

AsianPopulation | The estimate of Asian population per ZIP | integer | |

HawaiianPopulation | The estimate of Hawaiian or Pacific Islander population per ZIP code | integer | |

IndianPopulation | The estimate of American Indian and Alaska Native population per ZIP code | integer | |

OtherPopulation | The estimate population for all other races per ZIP code | integer | |

MalePopulation | The estimate of Male population per ZIP code | integer | |

FemalePopulation | The estimate of Female population per ZIP code | integer | |

PopulationUnder5 | The population estimate children 5 and under | integer | |

Population5to9 | The population estimate children 5 to 9 | integer | |

Population10to14 | The population estimate children 10 to14 | integer | |

Population15to19 | The population estimate 15 to 19 | integer | |

Population20to24 | The population estimate 20 to 24 | integer | |

Population25to29 | The population estimate 25 to 29 | integer | |

Population30to34 | The population estimate 30 to 34 | integer | |

Population35to39 | The population estimate 35 to 39 | integer | |

Population40to44 | The population estimate 40 to 44 | integer | |

Population45to49 | The population estimate 45 to 49 | integer | |

Population50to54 | The population estimate 50 to 54 | integer | |

Population55to59 | The population estimate 55 to 59 | integer | |

Population60to64 | The population estimate 60 to 64 | integer | |

Population65to69 | The population estimate 65 to 69 | integer | |

Population70to74 | The population estimate 70 to 74 | integer | |

Population75to79 | The population estimate 75 to 79 | integer | |

Population80to84 | The population estimate 80 to 84 | integer | |

Population85Plus | The population estimate 85 plus | integer | |

PopulationMedian | The population median | decimal | |

Population16Plus | The population estimate 16 plus | integer | |

Population18Plus | The population estimate 18 plus | integer | |

Population21Plus | The population estimate 21 plus | integer | |

Population62Plus | The population estimate 62 plus | integer | |

Population65Plus | The population estimate 65 plus | integer | |

PopulationMale | The population estimate all males | integer | |

PopulationMaleUnder5 | The male population under 5 | integer | |

PopulationMale5to9 | The male population 5 to 9 | integer | |

PopulationMale10to14 | The male population 10 to 14 | integer | |

PopulationMale15to19 | The male population 15 to 19 | integer | |

PopulationMale20to24 | The male population 20 to 24 | integer | |

PopulationMale25to29 | The male population 25 to 29 | integer | |

PopulationMale30to34 | The male population 30 to 24 | integer | |

PopulationMale35to39 | The male population 35 to 39 | integer | |

PopulationMale40to44 | The male population 40 to 44 | integer | |

PopulationMale45to49 | The male population 45 to 49 | integer | |

PopulationMale50to54 | The male population 50 to 54 | integer | |

PopulationMale55to59 | The male population 55 to 59 | integer | |

PopulationMale60to64 | The male population 60 to 64 | integer | |

PopulationMale65to69 | The male population 65 to 69 | integer | |

PopulationMale70to74 | The male population 70 to 74 | integer | |

PopulationMale75to79 | The male population 75 to 79 | integer | |

PopulationMale80to84 | The male population 80 to 84 | integer | |

PopulationMaleMedian | The male population median | decimal | |

PopulationMale16Plus | The male population 16 plus | integer | |

PopulationMale18Plus | The male population 18 plus | integer | |

PopulationMale21Plus | The male population 21 plus | integer | |

PopulationMale62Plus | The male population 62 plus | integer | |

PopulationMale65Plus | The male population 65 plus | integer | |

PopulationMale85Plus | The male population 85 plus | integer | |

PopulationFemale | The total female population | integer | |

PopulationFemaleUnder5 | The female population under 5 | integer | |

PopulationFemale5to9 | The female population 5 to 9 | integer | |

PopulationFemale10to14 | The female population 10 to 14 | integer | |

PopulationFemale15to19 | The female population 15 to 19 | integer | |

PopulationFemale20to24 | The female population 20 to 24 | integer | |

PopulationFemale25to29 | The female population 25 to 29 | integer | |

PopulationFemale30to34 | The female population 30 to 34 | integer | |

PopulationFemale35to39 | The female population 35 to 39 | integer | |

PopulationFemale40to44 | The female population 40 to 49 | integer | |

PopulationFemale45to49 | The female population 45 to 49 | integer | |

PopulationFemale50to54 | The female population 50 to 54 | integer | |

PopulationFemale55to59 | The female population 55 to 59 | integer | |

PopulationFemale60to64 | The female population 60 to 64 | integer | |

PopulationFemale65to69 | The female population 65 to 69 | integer | |

PopulationFemale70to74 | The female population 70 to 74 | integer | |

PopulationFemale75to79 | The female population 75 to 79 | integer | |

PopulationFemale80to84 | The female population 80 to 84 | integer | |

PopulationFemale85Plus | The female population 85 plus | integer | |

PopulationFemaleMedian | The female population median | decimal | |

PopulationFemale16Plus | The female population 16 plus | integer | |

PopulationFemale18Plus | The female population 18 plus | integer | |

PopulationFemale21Plus | The female population 21 plus | integer | |

PopulationFemale62Plus | The female population 62 plus | integer | |

PopulationFemale65Plus | The female population 65 plus | integer | |

Household and Family - Census 2010 | |||

AverageHouseholdSize | The average household size | decimal | |

AverageFamilySize | The average family size | decimal | |

TotalHouseholds | Total households | integer | |

FamilyHouseholds | Total family households | integer | |

FamilyHouseholdsWithChildrenUnder18 | Total family households with children under 18 | integer | |

FamilyHouseholdsHusbandWifeFamily | Total family households with wife/husband | integer | |

FamilyHouseholdsHusbandWifeFamilyChildrenUnder18 | Total family households with wife/husband and children under 18 | integer | |

FamilyHouseholdsMaleNoWife | Total family households with only male | integer | |

FamilyHouseholdsMaleNoWifeChildrenUnder18 | Total family households with only male and children under 18 | integer | |

FamilyHouseholdFemaleNoHusband | Total family households with only female | integer | |

FamilyHouseholdFemaleNoHusbandChildrenUnder18 | Total family households with only female and children under 18 | integer | |

NonFamilyHouseholds | Non family households - i.e. Single w/ no kids | integer | |

NonFamilyHouseholdsLivingAlone | Non family households Solo | integer | |

NonFamilyHouseholdsLivingAloneMale | Non family households Male and Solo | integer | |

NonFamilyHouseholdsLivingAloneMale65plus | Non family households Male, Solo, and over 65 | integer | |

NonFamilyHouseholdsLivingAloneFemale | Non family households Female and Solo | integer | |

NonFamilyHouseholdsLivingAloneFemale65plus | Non family households Female, Solo, and over 65 | integer | |

HouseholdsWithIndividualsUnder18 | Households with children under 18 | integer | |

HouseholdsWithIndividuals65plus | Households with individuals 65 plus | integer | |

TotalHousingUnits | Total housing units | integer | |

OccupiedHousingUnits | Occupied Housing Units | integer | |

VacantHousingUnits | Vacant homes | integer | |

VacantHousingUnitsForRent | Homes for rent | integer | |

VacantHousingUnitsRentedNotOccupied | Homes for rent and not occupied | integer | |

VacantHousingUnitsForSale | Homes for sale | integer | |

VacantHousingUnitsSoldNotOccupied | Homes sold and not occupied | integer | |

VacantHousingUnitsForSeasonalOccasionalUse | Vacant homes (only seasonal) | integer | |

VacantHousingUnitsAllOtherVacants | All other vacant homes | integer |