Zip+4 Demographic Append Documentation
- API Overview
- Pricing
LifeData® APIs
- Contact APIs
- Email Append API
- Phone Append API
- Address Append API
- Online Audience Builder API
- Social Handle Append API
- Demographic APIs
- Demographic Append API
- Lifestyle and Interests Append API
- Financial, Household and Auto Append API
- ZIP Demographic Append API
- ZIP+4 Demographic
Append API - Predictive Scores APIs
- Green Score API
- Giving Score Append API
- Wealth Score API
- Auto Buyer Score API
- Technology Buyer Score API
- Online Shopper Score API
- Travel Score API
- DIY Score API
- Hygiene APIs
- Hygiene and Lead Validation API
Documentation
- Append APIs
- Overview
- API Data Dictionary
- Match Codes
- Specific Services
- Contact Append API
- Online Audience Builder API
- Social Handle Append API
- Predictive Scores Append API
- Demographic Append API
- Lifestyle and Interests Append API
- Financial, Household and Auto Append API
- ZIP Demographic Append API
- ZIP+4
Demographic
Append API - Hygiene APIs
- Hygiene and Lead Validation API
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" } }