API Overview - Datafinder is a service of Versium

Zip+4 Demographic Append Documentation

Zip+4 Demographic Append Overview

Append LifeData^® (extensive demographic data) to any zip+4 in the United States. With over 44 million zip+4 codes in the US, each zip+4 represents as few as 8 people. This fine level of granularity, covering the entire US, provides valuable insight into any US location.

Request URL

https://api.datafinder.com/v2/qdf.php?k2={your-key}&service=zip4

Parameters

Config Parameters

Use the config parameters to adjust elements like the output language.

Name	Description	Required?
k2	Your api key	Yes
service	Which API service to use. Use "demo" in this case.	Yes
output	Specify json or xml output responses. Default is JSON. Example:output=json

Search Parameters

Any parameter that begins with a "d_" is a search parameter. We will attempt to map these to a Zip+4. Some search parameters cannot be used by themselves, such as d_last. If a search parameter requires another, it will be noted in the table below.

Name	Description
d_zip4	A 4 digit zip+4 in the USA. Example:d_zip4=4088
d_zip	A 5 digit zip code in the USA. Requires: d_fulladdr Example:d_zip=87402

Output Schema

Api results will follow the schema shown below and will include:

version - api version
query-id - id unique to each query
results - list of append results
input-query - list of input search parameters and their values
num-results - number of match records for the given search parameters
query-time - how long the processing took
page-time - how long the lookup took
AddrStdSimilarity - if results are found and search parameters other than d_zip4 and d_zip are used, this number represents how strong of a mapping exists between the input search parameters and the found zip+4.

For a list of fields returned, please see the examples section below.

Output schema in JSON:

{
  "datafinder": {
    "version": "2.0",
    "query-id": "xxxxxx",
    "results": [
      {
        "key": "value"
      }
    ],
    "input-query": {
      "key": "value"
    },
    "num-results": 1,
    "query-time": "0.000",
    "page-time": "0.000"
  }
}

If no matching records are found, the result would appear as follows:

{
  "datafinder": {
    "version": "2.0",
    "query-id": "xxx",
    "input-query": {
      "PostalCode": "98036",
      "Zip4": "1291"
    },
    "num-results": 0,
    "query-time": "0.138",
    "page-time": "0.193"
  }
}

In this case, the zip+4, "1291" does not exist in the zip, "98036". Some other reasons for not find matching a matching record could include:

Zip+4 input does not actually exist
Search parameters inputs cannot be mapped to a zip+4

Example Queries and Response

Search for zip+4 demographics using a zip4 and zip search parameters. Output is formatted as JSON:

https://api.datafinder.com/v2/qdf.php?k2=key&service=zip4&d_zip4=6746&d_zip=98077

                               
{
  "datafinder": {
    "version": "2.0",
    "query-id": "xxx",
    "results": [
      {
        "Zip5": "98077",
        "Zip4": "6746",        
        "State": "WA",        
        "Latitude": 47.770158,
        "Longitude": "-122040093",        
        "Population": "6",
        "Households": "2",
        "PopGrowth3Yr": "2.34",
        "AvgHouseholdSize": "2.98",
        "MedianHouseholderAge": "51.8",
        "MedianHousingRent": "1773",
        "HousingMedianValueOwnerHouseholds": "611168",
        "MedianHouseholdVehicles": "1.5",
        "MedianHouseholdIncome": "131660",
        "AverageHouseholdIncome": "153605",
        "HouseholdIncomePerCapita": "50699",
        "MedianAge": "43.1",
        "PctgHouseholdsIncomeOver200k": "16.7",
        "HighIncomeAverageHouseholdIncome": "374453",
        "PctgOwnerOccupiedHouseholds": "94.34",
        "PctgRenterOccupiedHouseholds": "5.66",
        "PctgWhitePopulation": "89.29",
        "PctgBlackPopulation": "0.83",
        "PctgPacificIslanderPopulation": "5.22",
        "PctgNativePopulation": "0.41",
        "PctgOtherRacePopulation": "0.28",
        "TwoOrMoreRacesPopultation": "3.97",
        "PctgHispanicPopulation": "3.61",
        "PctgNonHispanicWhitePopulation": "86.01",
        "PctgGraduateDegree": "31.93",
        "PctgWhiteCollearEmployment": "47.49",
        "PctgMarriedCouplesNoChildren": "40.23",
        "PctgMarriedCouplesWithChildren": "39.88",
        "PctgSingleParentsWithChildren": "4.53",
        "PctgSinglesAndUnrelatedIndividuals": "15.36",
        "PctgHHAged25to34": "4.14",
        "PctgHHAged35to44": "19.01",
        "PctgHHAged45to54": "39.13",
        "PctgHHAged55to64": "25.06",
        "PctgHHAged65to74": "10.55",
        "PctgHHAged75orOver": "2.11",
        "PctgHHEarns35to100k": "26.8",
        "PctgHHEarns100kOrOver": "65.36",
        "DonationsToCharitiesK": "550.7",
        "DonationsToChurchK": "917.3",
        "DonationsToEduK": "65.5",
        "DonationsPoliticsK": "25.4",
        "DonationsOtherK": "523",
        "ValueOfFinancialAssetsK": "84901.3",
        "ValueOfSavingsAcctsK": "14030.8",
        "ValueOfCheckingAcctsK": "9000.6",
        "ValueOfUSBondsK": "286.3",
        "ValueOfAllSecuritiesK": "62695.2",
        "CollegeTuitionK": "1368.8",
        "ElementaryTuitionK": "432.9",
        "HomeownersInsuranceK": "528.4",
        "VehicleInsuranceK": "1255.4",
        "HealthInsuranceK": "2405.4",
        "PersonalInsuranceK": "11482",
        "LifeInsuranceK": "564.2",
        "AnnuityInsuranceK": "531.6",
        "OwnedVacationHomeValueK": "654.2",
        "AirlineFaresK": "826.5",
        "FuneralExpensesK": "64.4",
        "InterestPaidHomeEquityLoanK": "109.9",
        "MortgageInterestK": "5646.4"
      }
    ],
    "input-query": {
      "PostalCode": "98077",
      "Zip4": "6746"
    },
    "num-results": 1,
    "query-time": "0.292",
    "page-time": "0.345"
  }
}