Upgrading To Community API V4
Introduction
The new community API V4 represents a significant enhancement to the API. We have dramatically increased the amount of information available and much of the existing data has changed in various ways. As a result, we recommend everyone making use of the original Community API V2 look closely at the changes and decide how to take advantage of the changes being made for their own projects.
- We have moved to a new vendor who provides a significant number of improvements to the amount of community data provided. This is the same data that supports ATTOM Cloud.
- The total number of fields available has increased from 387 to 631. This is consistent with the community data already available in ATTOM Cloud.
- Some of the existing fields have been retired, either because they are no longer available, no longer make sense, or had already been deprecated by the original source but never removed.
- The definitions of ranges and what is included in each statistic have changed in many cases.
- Many of the statistics provided are now expressed as percentages rather than raw numbers.
- Almost all the fields have new names consistent with those used in ATTOM Cloud.
- Census data is published every ten years. This is supported by additional surveys that take place in the intervening years. Our vendors use these to model the data and provide data for intervening years. This means historical data will be restated to adopt the models developed by our new vendor.
- We are no longer supporting the aggregation of community data for School Attendance Areas or School District boundaries.
- The geocoded used to identify a specific geographic area has changed to adopt the standardized geocoded employed across all other remaining ATTOM products. The new geocoded (geoIdV4) has been added to all endpoints that previously provided geocoded. Endpoints that support searching via a geocode will now accept the new geocodes.
This is viewed as a breaking change and customers are encouraged to make changes on or before June 30, 2023
Endpoints Affected
The following endpoint is impacted by this change
Name | Original Endpoint | New Endpoint |
Community | /communityapi/v2.0.0/area/full | /v4/neighborhood/community |
Data Enhancements
Air Quality
- Air Quality details are now grouped in their own block, making them easier to locate.
"airQuality": { "ozone_Index": 115, "lead_Index": 229, "carbon_Monoxide_Index": 94, "nitrogen_Dioxide_Index": 91, "particulate_Matter_Index": 86, "air_Pollution_Index": 114 }<br>
Climate
- A much more complete description of the climate for an area is now available.
- Average min/max temperatures are now available for the year and each month. Previously only data for Winter (Jan) and Summer (Jul) was provided.
- Average precipitation amounts have been added for each month
- Additional measures for the average number of days that are clear, sunny, rainy, or have snow.
- Climate details are included in their own block, making them easier to locate.
"climate": { "annual_Avg_Temp_Min": 61.36, "annual_Avg_Temp_Max": 82.41, "annual_Avg_Temp": 71.89, "possible_Sunshine_Pct": 64, "sky_Cover_Mean": 6, "clear_Day_Mean": 90, "rainy_Day_Mean": 116, "snow_Day_Mean": 0, "annual_Precip_In": 51.87, "annual_Snowfall_In": 0, "avg_Jan_Low_Temp": 48.63, "avg_Feb_Low_Temp": 50.32, "avg_Mar_Low_Temp": 54.77, "avg_Apr_Low_Temp": 59.41, "avg_May_Low_Temp": 65.32, "avg_Jun_Low_Temp": 70.47, "avg_Jul_Low_Temp": 72.21, "avg_Aug_Low_Temp": 72.41, "avg_Sep_Low_Temp": 71.19, "avg_Oct_Low_Temp": 64.85, "avg_Nov_Low_Temp": 56.35, "avg_Dec_Low_Temp": 50.41, "avg_Jan_High_Temp": 70.92, "avg_Feb_High_Temp": 73.17, "avg_Mar_High_Temp": 77.77, "avg_Apr_High_Temp": 82.67, "avg_May_High_Temp": 87.89, "avg_Jun_High_Temp": 90.46, "avg_Jul_High_Temp": 91.69, "avg_Aug_High_Temp": 91.35, "avg_Sep_High_Temp": 89.2, "avg_Oct_High_Temp": 83.8, "avg_Nov_High_Temp": 77.68, "avg_Dec_High_Temp": 72.37, "avg_Jan_Precip_In": 2.91, "avg_Feb_Precip_In": 2.75, "avg_Mar_Precip_In": 3.71, "avg_Apr_Precip_In": 2.58, "avg_May_Precip_In": 3.73, "avg_Jun_Precip_In": 7.03, "avg_Jul_Precip_In": 7.27, "avg_Aug_Precip_In": 7.35, "avg_Sep_Precip_In": 6.17, "avg_Oct_Precip_In": 3.3, "avg_Nov_Precip_In": 2.58, "avg_Dec_Precip_In": 2.49 }
Crime
- New indexes have been adopted replacing all previous historical data provided.
- Crime statistics are now included in their own block, making them easier to locate
"crime": { "mortality_Index": 157, "murder_Index": 111, "forcible_Rape_Index": 31, "forcible_Robbery_Index": 128, "aggravated_Assault_Index": 100, "burglary_Index": 66, "larceny_Index": 120, "motor_Vehicle_Theft_Index": 104, "crime_Index": 121 }
Demographics
- New categories added to household expenditure - e.g. alcoholic beverages, dairy, prescription drugs, health insurance
- New categories added to retail sales - e.g. building materials and garden stores, clothing and accessories, electrical and appliance stores
- Median ages for ethnic groups
- CPI figures for various categories of products - e.g. apparel, education & communication, recreation, transportation
- Dissection of household and family structures based upon the number of members of each family unit from 1-6 and 7+ and various other characteristics
- Statistics for household income for various income categories, including family and non-family incomes.
- Number of businesses in various industry segments
- Dissection of types of heating fuel used in homes
- Age of home
- Number of housing units in multi-family buildings
- Homes with and without mortgages
- Dissection of average rent paid
- Occupied and unoccupied housing units
- Dissection of the length of occupancy of the home
- The breakup of the population by gender in age bands
- The breakup of the civilian and military population
- Breakup of meal
- Usage levels of public transportation
- Even though there are hundreds of fields, we have grouped them into their own block to make them easier to locate
Natural Disasters
- Natural Hazards data is now included in its own block, making it easier to locate.
"naturalDisasters": { "weather_Index": 364, "earthquake_Index": 19, "hail_Index": 29, "hurricane_Index": 508, "tornado_Index": 260, "wind_Index": 79 }
Example
The following call requests community data for the Rejniak Chou Acres residential subdivision in Seminole County, FL (geoIdV4: dd4ec3218a89807fc1c63dd7265cc1bc)
https://api.gateway.attomdata.com/v4/neighborhood/community?geoIdv4=dd4ec3218a89807fc1c63dd7265cc1bc
{ "status": { "version": "4", "code": 0, "msg": "SuccessWithResult", "transactionID": "0470d72c55d6a578d7fe06ceff58139f" }, "community": { "geography": { "geoIDv4": "dd4ec3218a89807fc1c63dd7265cc1bc", "geographyName": "Rejniak Chou Acres, Casselberry, Seminole County, FL", "geographyTypeName": "Residential Subdivision", "area_Square_Mile": 0 }, "demographics": { "population_1990": 2, "population_2000": 2, "population_2010": 2, "population": 2, "population_5_Yr_Projection": 3, "population_Density_Sq_Mi": 2557.9, "population_3P": 2, "population_5P": 2, "population_Male_15P": 1, "population_Female_15P": 1, "population_16P": 2, "population_18P": 2, "population_Employed_16P": 1, "population_25P": 2, "population_Civilian_16P": 1, "population_Civilian_White_Collar_Or_Blue_Collar_16P": 1, "population_Daytime": 2, "population_Chg_Pct_1990": 46, "population_Chg_Pct_2000": 59, "population_Chg_Pct_2010": 10.17, "population_Chg_Pct_5_Yr_Projection": 2.46, "households_1990": 1, "households_2000": 1, "households_2010": 1, "households": 1, "households_5_Yr_Projection": 1, "household_Chg_Pct_1990": 65, "household_Chg_Pct_2000": 76, "household_Chg_Pct_2010": 11.65, "household_Chg_Pct_5_Yr_Projection": 3.04, "household_Size_Avg": 2.21, "population_Family_Pct": 73.08, "population_Non_Family_Pct": 26.92, "households_Family": 1, "households_Non_Family": 0, "households_Family_Pct": 56.3, "households_Non_Family_Pct": 43.7, "households_Family_Married_Pct": 41.52, "households_Family_Other_Pct": 14.78, "hh_Fam_Other_Male_Householder_No_Wife_Present_Pct": 4.13, "hh_Fam_Other_Female_Householder_No_Husband_Present_Pct": 10.65, "hh_Fam_Married_W_Children_L18_Pct": 15, "hh_Fam_Married_Wo_Children_L18_Pct": 26.52, "hh_Fam_Other_Male_Hh_No_Wife_Present_W_Children_L18_Pct": 2.17, "hh_Fam_Other_Male_Hh_No_Wife_Present_Wo_Children_L18_Pct": 1.96, "hh_Fam_Other_Female_Hh_No_Husband_Pres_W_Children_L18_Pct": 5.43, "hh_Fam_Other_Female_Hh_No_Husband_Pres_Wo_Children_L18_Pct": 5.22, "hh_Non_Family_Male_Householder_Pct": 17.17, "hh_Non_Family_Male_Hh_W_Children_L18_Pct": 0.43, "hh_Non_Family_Male_Hh_Wo_Children_L18_Pct": 16.74, "hh_Non_Family_Female_Householder_Pct": 26.52, "hh_Non_Family_Female_Hh_W_Children_L18_Pct": 0.22, "hh_Non_Family_Female_Hh_Wo_Children_L18_Pct": 26.3, "households_Family_W_Children_Pct": 22.61, "households_Family_Wo_Children_Pct": 33.7, "households_Non_Family_W_Children_Pct": 0.65, "households_Non_Family_Wo_Children_Pct": 43, "population_Urban_Pct": 100, "population_Rural_Pct": 0, "population_Male_Pct": 45.48, "population_Female_Pct": 54.52, "population_White_Pct": 80.55, "population_Black_Pct": 9.33, "population_Asian_Pct": 5.4, "population_American_Indian_Or_Alaskan_Native_Pct": 0, "population_Multiracial_Pct": 3.24, "population_Other_Race_Pct": 1.47, "population_White_Hispanic_Pct": 8.55, "population_White_Non_Hispanic_Pct": 72, "population_Non_White_Hispanic_Pct": 4.52, "population_Non_White_Non_Hispanic_Pct": 14.93, "population_Hispanic_Pct": 13.06, "population_Non_Hispanic_Pct": 86.94, "households_White_Pct": 86.96, "households_Black_Pct": 7.17, "households_Asian_Pct": 3.7, "households_American_Indian_Or_Alaskan_Native_Pct": 0, "households_Multiracial_Pct": 0.65, "households_Other_Race_Pct": 1.52, "households_White_Hispanic_Pct": 9.35, "households_White_Non_Hispanic_Pct": 77.61, "households_Non_White_Hispanic_Pct": 1.52, "households_Non_White_Non_Hispanic_Pct": 11.52, "households_Hispanic_Pct": 10.87, "households_Non_Hispanic_Pct": 89.13, "median_Age": 46.2, "population_Aged_0_5_Pct": 4.72, "population_Aged_6_11_Pct": 5.21, "population_Aged_12_17_Pct": 6.19, "population_Aged_18_24_Pct": 7.66, "population_Aged_25_34_Pct": 11.89, "population_Aged_35_44_Pct": 12.38, "population_Aged_45_54_Pct": 16.4, "population_Aged_55_64_Pct": 14.54, "population_Aged_65_74_Pct": 10.12, "population_Aged_75_84_Pct": 6.68, "population_Aged_85P_Pct": 4.22, "white_Median_Age": 46.8, "black_Median_Age": 45.8, "asian_Median_Age": 62.5, "american_Indian_Or_Alaskan_Native_Median_Age": 0, "multiracial_Median_Age": 21.1, "other_Race_Median_Age": 29, "hispanic_Median_Age": 33.9, "white_Non_Hispanic_Median_Age": 47.7, "male_Median_Age": 42.5, "female_Median_Age": 48.9, "population_Male_Aged_0_5_Pct": 4.32, "population_Male_Aged_6_11_Pct": 4.54, "population_Male_Aged_12_17_Pct": 7.13, "population_Male_Aged_18_24_Pct": 10.8, "population_Male_Aged_25_34_Pct": 12.31, "population_Male_Aged_35_44_Pct": 14.47, "population_Male_Aged_45_54_Pct": 15.98, "population_Male_Aged_55_64_Pct": 14.04, "population_Male_Aged_65_74_Pct": 9.07, "population_Male_Aged_75_84_Pct": 4.32, "population_Male_Aged_85P_Pct": 3.02, "population_Female_Aged_0_5_Pct": 5.05, "population_Female_Aged_6_11_Pct": 5.77, "population_Female_Aged_12_17_Pct": 5.41, "population_Female_Aged_18_24_Pct": 5.05, "population_Female_Aged_25_34_Pct": 11.53, "population_Female_Aged_35_44_Pct": 10.63, "population_Female_Aged_45_54_Pct": 16.76, "population_Female_Aged_55_64_Pct": 14.95, "population_Female_Aged_65_74_Pct": 10.99, "population_Female_Aged_75_84_Pct": 8.65, "population_Female_Aged_85P_Pct": 5.23, "population_Males_Never_Married_Pct": 35.56, "population_Males_Widowed_Pct": 4.2, "population_Males_Divorced_Pct": 6.42, "population_Males_Married_Pct": 53.83, "population_Males_Married_And_Together_Pct": 53.83, "population_Males_Married_And_Separated_Pct": 0, "population_Males_Married_And_Absent_Pct": 0, "population_Females_Never_Married_Pct": 23.95, "population_Females_Widowed_Pct": 14.92, "population_Females_Divorced_Pct": 22.06, "population_Females_Married_Pct": 39.08, "population_Females_Married_And_Together_Pct": 34.24, "population_Females_Married_And_Separated_Pct": 4.83, "population_Females_Married_And_Absent_Pct": 0, "population_Primary_Language_English_Pct": 76.64, "population_Primary_Language_Spanish_Pct": 20.29, "population_Primary_Language_Other_Indo_European_Pct": 1.84, "population_Primary_Language_Asian_Or_Other_Pacific_Island_Pct": 1.23, "population_Primary_Language_Other_Pct": 0, "population_Citizen_Native_Pct": 79.96, "population_Citizen_Naturalized_Pct": 13.06, "population_Non_Citizen_Pct": 6.97, "population_Group_Quarters_Pct": 0, "population_Institutional_Group_Quarters_Pct": 0, "population_Non_Institutional_Group_Quarters_Pct": 0, "population_In_Poverty_Pct": 17.39, "population_Veterans_Pct": 10.07, "family_Median_Size": 3.05, "families_1_Person_Pct": 0, "families_2_Persons_Pct": 48.65, "families_3_Persons_Pct": 28.96, "families_4_Persons_Pct": 14.29, "families_5_Persons_Pct": 3.86, "families_6_Persons_Pct": 3.09, "families_7_Or_More_Persons_Pct": 1.16, "non_Family_Median_Size": 1.66, "non_Families_1_Person_Pct": 75.12, "non_Families_2_Persons_Pct": 18.91, "non_Families_3_Persons_Pct": 4.98, "non_Families_4_Persons_Pct": 0.5, "non_Families_5_Persons_Pct": 0.5, "non_Families_6_Persons_Pct": 0, "non_Families_7_Or_More_Persons_Pct": 0, "median_Travel_Time_To_Work_Mi": 21, "travel_Time_To_Work_0_14_Mi_Pct": 23.28, "travel_Time_To_Work_15_29_Mi_Pct": 54.09, "travel_Time_To_Work_30_59_Mi_Pct": 22.63, "travel_Time_To_Work_60_89_Mi_Pct": 0, "travel_Time_To_Work_90_Or_More_Mi_Pct": 0, "transportation_Public_Pct": 0, "transportation_Car_Pct": 95.28, "transportation_Motorcycle_Pct": 0, "transportation_Bicycle_Pct": 0, "transportation_Walk_Pct": 0, "transportation_Other_Pct": 0, "transportation_Work_From_Home_Pct": 4.72, "transportation_Public_Bus_Pct": 0, "transportation_Public_Trolley_Pct": 0, "transportation_Public_Light_Rail_Pct": 0, "transportation_Public_Railroad_Pct": 0, "transportation_Public_Ferry_Pct": 0, "transportation_Public_Taxi_Pct": 0, "transportation_Car_Alone_Pct": 79.06, "transportation_Car_Carpool_Pct": 16.22, "householder_Median_Age": 53.7, "householder_Age_0_24_Pct": 3.26, "householder_Age_25_34_Pct": 11.74, "householder_Age_35_44_Pct": 15.65, "householder_Age_45_54_Pct": 22.17, "householder_Age_55_64_Pct": 19.13, "householder_Age_65_74_Pct": 13.04, "householder_Age_75_84_Pct": 8.91, "householder_Age_85_And_Over_Pct": 6.09, "median_Household_Size": 2.5, "households_1_Person_Pct": 32.83, "households_2_Persons_Pct": 35.65, "households_3_Persons_Pct": 18.48, "households_4_Persons_Pct": 8.26, "households_5_Persons_Pct": 2.39, "households_6_Persons_Pct": 1.74, "households_7_Or_More_Persons_Pct": 0.65, "housing_Units": 1, "housing_Units_Occupied": 1, "housing_Units_Vacant": 0, "housing_Units_Occupied_Pct": 92.37, "housing_Units_Vacant_Pct": 7.63, "housing_Units_Vacant_For_Rent_Pct": 15.79, "housing_Units_Vacant_Rented_Not_Occupied_Pct": 0, "housing_Units_Vacant_For_Sale_Pct": 28.95, "housing_Units_Vacant_Sold_Not_Occupied_Pct": 0, "housing_Units_Vacant_Seasonal_Pct": 15.79, "housing_Units_Vacant_For_Migrant_Workers_Pct": 0, "housing_Units_Vacant_Other_Pct": 39.47, "housing_Units_Owner_Occupied": 1, "housing_Units_Renter_Occupied": 0, "housing_Units_Owner_Occupied_Pct": 69.35, "housing_Units_Renter_Occupied_Pct": 30.65, "housing_Occupied_Structure_1_Unit_Detached_Pct": 56.3, "housing_Occupied_Structure_1_Unit_Attached_Pct": 13.48, "housing_Occupied_Structure_2_Units_Pct": 0, "housing_Occupied_Structure_3_4_Units_Pct": 30.22, "housing_Occupied_Structure_5_9_Units_Pct": 0, "housing_Occupied_Structure_10_19_Units_Pct": 0, "housing_Occupied_Structure_20_49_Units_Pct": 0, "housing_Occupied_Structure_50_Or_More_Units_Pct": 0, "housing_Occupied_Structure_Trailer_Pct": 0, "housing_Occupied_Structure_Other_Pct": 0, "housing_Median_Rent": 723, "housing_Rent_Less_Than_250_Pct": 0, "housing_Rent_250_499_Pct": 0, "housing_Rent_500_749_Pct": 51.06, "housing_Rent_750_999_Pct": 34.04, "housing_Rent_1000_1249_Pct": 0, "housing_Rent_1250_1499_Pct": 6.38, "housing_Rent_1500_1999_Pct": 0, "housing_Rent_2000_Or_More_Pct": 0, "housing_Rent_No_Cash_Pct": 8.51, "housing_Owner_Households_With_Mortgage_Pct": 63.32, "housing_Owner_Households_Without_Mortgage_Pct": 36.68, "housing_Owner_Households_Median_Value": 142619, "housing_Owner_Households_Valued_Less_Than_10000_Pct": 0, "housing_Owner_Households_Valued_10000_14999_Pct": 0, "housing_Owner_Households_Valued_15000_19999_Pct": 0, "housing_Owner_Households_Valued_20000_24999_Pct": 0, "housing_Owner_Households_Valued_25000_29999_Pct": 0, "housing_Owner_Households_Valued_30000_34999_Pct": 0, "housing_Owner_Households_Valued_35000_39999_Pct": 0, "housing_Owner_Households_Valued_40000_49999_Pct": 3.13, "housing_Owner_Households_Valued_50000_59999_Pct": 0, "housing_Owner_Households_Valued_60000_69999_Pct": 0, "housing_Owner_Households_Valued_70000_79999_Pct": 3.13, "housing_Owner_Households_Valued_80000_89999_Pct": 7.52, "housing_Owner_Households_Valued_90000_99999_Pct": 0, "housing_Owner_Households_Valued_100000_124999_Pct": 13.17, "housing_Owner_Households_Valued_125000_149999_Pct": 32.6, "housing_Owner_Households_Valued_150000_174999_Pct": 19.12, "housing_Owner_Households_Valued_175000_199999_Pct": 3.13, "housing_Owner_Households_Valued_200000_249999_Pct": 9.4, "housing_Owner_Households_Valued_250000_299999_Pct": 1.88, "housing_Owner_Households_Valued_300000_399999_Pct": 6.9, "housing_Owner_Households_Valued_400000_499999_Pct": 0, "housing_Owner_Households_Valued_500000_749999_Pct": 0, "housing_Owner_Households_Valued_750000_999999_Pct": 0, "housing_Owner_Households_Valued_1000000_Or_More_Pct": 0, "households_Median_Vehicles": 2.3, "households_With_No_Vehicles_Pct": 1.96, "households_With_1_Vehicle_Pct": 37.83, "households_With_2_Vehicles_Pct": 35.22, "households_With_3_Vehicles_Pct": 21.09, "households_With_4_Or_More_Vehicles_Pct": 3.91, "housing_Median_Built_Yr": 1983, "housing_Built_2010_Or_Later_Pct": 18.27, "housing_Built_2000_2009_Pct": 0, "housing_Built_1990_1999_Pct": 10.64, "housing_Built_1980_1989_Pct": 37.55, "housing_Built_1970_1979_Pct": 9.04, "housing_Built_1960_1969_Pct": 15.06, "housing_Built_1950_1959_Pct": 9.44, "housing_Built_1940_1949_Pct": 0, "housing_Built_1939_Or_Earlier_Pct": 0, "median_Length_Of_Residence_Yr": 19, "moved_In_2010_Or_Later_Pct": 59.13, "moved_In_2000_2009_Pct": 13.26, "moved_In_1990_1999_Pct": 14.13, "moved_In_1980_1989_Pct": 10, "moved_In_1970_1979_Pct": 1.52, "moved_In_1969_Or_Earlier_Pct": 1.96, "personal_Income": 68300, "household_Income": 68300, "median_Household_Income": 49516, "avg_Household_Income": 61244, "household_Income_Per_Capita": 27674, "household_Income_High_Income_Avg": 243750, "households_Income_Less_Than_15000_Pct": 18.91, "households_Income_15000_24999_Pct": 10.43, "households_Income_25000_34999_Pct": 7.61, "households_Income_35000_49999_Pct": 13.48, "households_Income_50000_74999_Pct": 17.17, "households_Income_75000_99999_Pct": 12.83, "households_Income_100000_124999_Pct": 9.35, "households_Income_125000_149999_Pct": 1.3, "households_Income_150000_199999_Pct": 7.83, "households_Income_200000_And_Over_Pct": 1.09, "family_Income": 52974, "family_Median_Income": 81250, "family_Avg_Income": 84366, "family_Per_Capita_Income": 29369, "family_Income_High_Income_Avg": 208500, "families_Income_Less_Than_15000_Pct": 8.88, "families_Income_15000_24999_Pct": 6.18, "families_Income_25000_34999_Pct": 5.41, "families_Income_35000_49999_Pct": 3.47, "families_Income_50000_74999_Pct": 20.46, "families_Income_75000_99999_Pct": 22.78, "families_Income_100000_124999_Pct": 16.22, "families_Income_125000_149999_Pct": 0.77, "families_Income_150000_199999_Pct": 13.9, "families_Income_200000_And_Over_Pct": 1.93, "non_Family_Income": 15808, "non_Family_Median_Income": 27273, "non_Family_Avg_Income": 32439, "non_Family_Per_Capita_Income": 23797, "non_Families_Income_Less_Than_15000_Pct": 31.84, "non_Families_Income_15000_24999_Pct": 15.92, "non_Families_Income_25000_34999_Pct": 10.45, "non_Families_Income_35000_49999_Pct": 26.37, "non_Families_Income_50000_74999_Pct": 12.94, "non_Families_Income_75000_99999_Pct": 0, "non_Families_Income_100000_124999_Pct": 0.5, "non_Families_Income_125000_149999_Pct": 1.99, "non_Families_Income_150000_199999_Pct": 0, "non_Families_Income_200000_And_Over_Pct": 0, "enrollment_Public_Preprimary_Pct": 0, "enrollment_Private_Preprimary_Pct": 0, "enrollment_Public_Kindergarten_Pct": 1.11, "enrollment_Private_Kindergarten_Pct": 0, "enrollment_Public_Grades_1_4_Pct": 0, "enrollment_Private_Grades_1_4_Pct": 0, "enrollment_Public_Grades_5_8_Pct": 6.13, "enrollment_Private_Grades_5_8_Pct": 0, "enrollment_Public_Grades_9_12_Pct": 2.31, "enrollment_Private_Grades_9_12_Pct": 0, "enrollment_Public_Undergraduate_College_Pct": 12.56, "enrollment_Private_Undergraduate_College_Pct": 0, "enrollment_Public_Graduate_Or_Professional_School_Pct": 2.11, "enrollment_Private_Graduate_Or_Professional_School_Pct": 0, "enrollment_Not_Enrolled_In_School_Pct": 75.78, "education_Some_Hs_Pct": 8.51, "education_Hs_Pct": 36.86, "education_Some_College_Pct": 23.45, "education_Assoc_Degree_Pct": 10.95, "education_Bach_Degree_Pct": 14.69, "education_Mast_Degree_Pct": 5.54, "education_Prof_Degree_Pct": 0, "education_Doct_Degree_Pct": 0, "education_Grad_Degree_Pct": 5.54, "population_16P_Civilian_Male_Pct": 24.34, "population_16P_Civilian_Female_Pct": 31.31, "population_16P_Armed_Forces_Male_Pct": 0, "population_16P_Armed_Forces_Female_Pct": 0, "population_16P_Unemployed_Male_Pct": 0.69, "population_16P_Unemployed_Female_Pct": 0.91, "population_16P_Not_In_The_Labor_Force_Male_Pct": 17.49, "population_16P_Not_In_The_Labor_Force_Female_Pct_Pct": 25.26, "emp_Agri_Pct": 0, "emp_Mine_Pct": 0, "emp_Const_Pct": 9.86, "emp_Manuf_Pct": 0, "emp_Whole_Pct": 5.75, "emp_Retail_Pct": 6.37, "emp_Trans_Pct": 5.54, "emp_Utils_Pct": 0, "emp_Info_Pct": 0, "emp_Finetc_Pct": 8.83, "emp_Real_Pct": 1.85, "emp_Prof_Pct": 9.24, "emp_Manag_Pct": 0, "emp_Admin_Pct": 8.21, "emp_Educ_Pct": 0.82, "emp_Health_Pct": 9.65, "emp_Arts_Pct": 11.29, "emp_Accom_Pct": 6.57, "emp_Otsrv_Pct": 4.52, "emp_Pubad_Pct": 11.5, "occupation_Management_Business_And_Financial_Operations_Pct": 8.42, "occupation_Professional_And_Related_Pct": 17.66, "occupation_Sales_And_Office_Pct": 26.9, "occupation_Service_Pct": 22.38, "occupation_Farming_Fishing_And_Forestry_Pct": 0, "occupation_Construction_Extraction_And_Maintenance_Pct": 13.14, "occupation_Production_Transportation_And_Material_Moving_Pct": 11.5, "occupation_White_Collar_Pct": 68.25, "occupation_Blue_Collar_Pct": 31.75, "private_For_Profit_Employee_Pct": 62.83, "private_For_Profit_Self_Employed_Pct": 5.54, "private_Not_For_Profit_Employee_Pct": 10.68, "local_Government_Employee_Pct": 3.9, "state_Government_Employee_Pct": 3.29, "federal_Government_Employee_Pct": 3.9, "not_Incorporated_Self_Employed_Pct": 9.86, "unpaid_Family_Worker_Pct": 0, "employee_Naics_Cnt": 0, "employee_Forestry_Fishing_Hunting_Agriculture_Naics_Pct": 0, "employee_Mining_Naics_Pct": 0, "employee_Utilities_Naics_Pct": 0, "employee_Construction_Naics_Pct": 0, "employee_Manufacturing_Naics_Pct": 2.22, "employee_Wholesale_Trade_Naics_Pct": 11.11, "employee_Retail_Trade_Naics_Pct": 68.89, "employee_Transportation_Warehousing_Naics_Pct": 0, "employee_Information_Naics_Pct": 0, "employee_Finance_Insurance_Naics_Pct": 11.11, "employee_Real_Estate_Naics_Pct": 0, "employee_Professional_Scientific_Technical_Svcs_Naics_Pct": 0, "employee_Management_Companies_Enterprises_Naics_Pct": 0, "employee_Admin_Support_Waste_Management_Naics_Pct": 3.33, "employee_Education_Services_Naics_Pct": 0, "employee_Health_Care_Social_Assistance_Naics_Pct": 3.33, "employee_Arts_Entertainment_Recreation_Naics_Pct": 0, "employee_Accommodation_Food_Svcs_Naics_Pct": 0, "employee_Other_Svcs_Excluding_Public_Admin_Naics_Pct": 0, "establishment_Naics_Cnt": 0, "establishment_Forestry_Fishing_Hunting_Agriculture_Naics_Pct": 0, "establishment_Mining_Naics_Pct": 0, "establishment_Utilities_Naics_Pct": 0, "establishment_Construction_Naics_Pct": 0, "establishment_Manufacturing_Naics_Pct": 4, "establishment_Wholesale_Trade_Naics_Pct": 12, "establishment_Retail_Trade_Naics_Pct": 44, "establishment_Transportation_Warehousing_Naics_Pct": 0, "establishment_Information_Naics_Pct": 0, "establishment_Finance_Insurance_Naics_Pct": 24, "establishment_Real_Estate_Naics_Pct": 0, "establishment_Professional_Scientific_Technical_Svcs_Naics_Pct": 0, "establishment_Management_Companies_Enterprises_Naics_Pct": 0, "establishment_Admin_Support_Waste_Management_Naics_Pct": 8, "establishment_Education_Services_Naics_Pct": 0, "establishment_Health_Care_Social_Assistance_Naics_Pct": 8, "establishment_Arts_Entertainment_Recreation_Naics_Pct": 0, "establishment_Accommodation_Food_Svcs_Naics_Pct": 0, "establishment_Other_Svcs_Excluding_Public_Admin_Naics_Pct": 0, "occupation_Soc_Cnt": 0, "occupation_Management_Soc_Pct": 5.19, "occupation_Business_Financial_Operations_Soc_Pct": 4.14, "occupation_Computer_Math_Science_Soc_Pct": 1.35, "occupation_Architecture_Engineering_Soc_Pct": 0.18, "occupation_Life_Physical_Social_Sciences_Soc_Pct": 0.14, "occupation_Community_Social_Svcs_Soc_Pct": 0.79, "occupation_Legal_Soc_Pct": 0.2, "occupation_Education_Training_Library_Soc_Pct": 0.11, "occupation_Art_Design_Entertainment_Sports_Media_Soc_Pct": 1.34, "occupation_Healthcare_Practitioners_Tech_Ops_Soc_Pct": 0.32, "occupation_Healthcare_Support_Soc_Pct": 0.06, "occupation_Protective_Service_Soc_Pct": 0.12, "occupation_Food_Preparation_Serving_Related_Soc_Pct": 0.17, "occupation_Building_Grounds_Cleaning_Maintenance_Soc_Pct": 0.74, "occupation_Personal_Care_Service_Soc_Pct": 8.66, "occupation_Sales_Soc_Pct": 47.97, "occupation_Administrative_Support_Soc_Pct": 14.56, "occupation_Farming_Fishing_Forestry_Soc_Pct": 0.47, "occupation_Construction_Extraction_Soc_Pct": 0.4, "occupation_Installation_Maintenance_Repair_Soc_Pct": 3.47, "occupation_Production_Operations_Soc_Pct": 3.28, "occupation_Transportation_Material_Moving_Soc_Pct": 6.29, "households_Heating_Fuel_Utility_Gas_Pct": 7.17, "households_Heating_Fuel_Bottled_Tank_Or_Lp_Gas_Pct": 0, "households_Heating_Fuel_Electricity_Pct": 91.09, "households_Heating_Fuel_Fuel_Oil_Kerosene_Pct": 1.74, "households_Heating_Fuel_Coal_Coke_Pct": 0, "households_Heating_Fuel_Wood_Pct": 0, "households_Heating_Fuel_Solar_Energy_Pct": 0, "households_Heating_Fuel_Other_Fuel_Pct": 0, "households_Heating_Fuel_None_Pct": 0, "retail_Sales_Amt": 33, "furniture_And_Home_Furnishing_Sales_Amt": 0, "electrical_And_Appliance_Store_Sales_Amt": 0, "building_Materials_And_Garden_Store_Sales_Amt": 0, "food_And_Beverage_Store_Sales_Amt": 0, "health_And_Personal_Care_Store_Sales_Amt": 0, "gas_Station_Store_Sales_Amt": 0, "clothing_And_Accessories_Store_Sales_Amt": 0, "sporting_Goods_Store_Sales_Amt": 0, "general_Merchandise_Store_Sales_Amt": 0, "miscellaneous_Store_Sales_Amt": 33, "non_Store_Purchase_Sales_Amt": 0, "food_Services_Sales_Amt": 0, "consumerPriceIndex": 237.4, "consumerPriceIndex_Apparel": 133.6, "consumerPriceIndex_Education_And_Communications": 132.7, "consumerPriceIndex_Food_And_Beverages": 247.8, "consumerPriceIndex_Other_Goods_And_Services": 419.7, "consumerPriceIndex_Housing": 231.9, "consumerPriceIndex_Medical_Care": 456.4, "consumerPriceIndex_Recreation": 117.5, "consumerPriceIndex_Transportation": 202.7, "costIndex_Annual_Expenditures": 131.5, "costIndex_Food": 134.1, "costIndex_Food_At_Home": 136.1, "costIndex_Cereals_And_Bakery_Products": 125, "costIndex_Dairy": 131.2, "costIndex_Fruits_And_Vegetables": 137.9, "costIndex_Non_Alcoholic_Beverages": 138, "costIndex_Food_Prepared_By_Consumer_Unit_On_Trips": 206.1, "costIndex_Local_Restaurants": 131.5, "costIndex_Restaurants_On_Trips": 135.4, "costIndex_Alcoholic_Beverages": 122.8, "costIndex_Housing": 133.7, "costIndex_Household_Operations": 126.5, "costIndex_Housekeeping_Services": 155.4, "costIndex_Household_Furnishings_And_Equipment": 129.6, "costIndex_Household_Textiles": 106.3, "costIndex_Furniture": 139.9, "costIndex_Floor_Coverings": 0, "costIndex_Major_Appliances": 117.5, "costIndex_Small_Appliances": 0, "costIndex_Miscellaneous_Household_Equipment": 124.7, "costIndex_Apparel_And_Services": 130.4, "costIndex_Men_And_Boys": 143.7, "costIndex_Men_16_And_Over": 143.9, "costIndex_Apparel_Boys": 139.2, "costIndex_Women_And_Girls": 128.5, "costIndex_Women_16_And_Over": 134.1, "costIndex_Apparel_Girls": 99.1, "costIndex_Apparel_Children": 155.3, "costIndex_Footwear": 124.5, "costIndex_Other_Apparel_Products_And_Services": 114.9, "costIndex_Transportation": 131.8, "costIndex_Vehicle_Purchase_Net_Outlay": 129.8, "costIndex_Gasoline_And_Motor_Oil": 137.2, "costIndex_Other_Vehicle_Expenses": 134.9, "costIndex_Public_Transportation": 133.6, "costIndex_Healthcare": 133.2, "costIndex_Health_Insurance": 136.2, "costIndex_Medical_Services": 127.7, "costIndex_Drugs": 145.7, "costIndex_Medical_Supplies": 134.3, "costIndex_Entertainment": 131, "costIndex_Fees_And_Admissions": 122.4, "costIndex_Audio_And_Visual_Equipment_And_Services": 131.4, "costIndex_Pets_Toys_Hobbies_And_Playground_Equipment": 127.9, "costIndex_Other_Entertainment_Supplies_Equipment_And_Services": 124.9, "costIndex_Personal_Care_Products_And_Services": 127.8, "costIndex_Reading": 108, "costIndex_Education": 132.6, "costIndex_Tobacco": 142.4, "costIndex_Cash_Contributions": 128.3, "costIndex_Personal_Insurance_And_Pensions": 127.3, "home_Maintenance_Repairs_Insurance_And_Other_Expenses": 130.3, "utilities_Fuels_And_Public_Services": 136, "natural_Gas": 149.1, "costIndex_Electricity": 139.8, "phone_Residential": 110.8, "phone_Cellular": 133.2 }, "crime": { "mortality_Index": 157, "murder_Index": 111, "forcible_Rape_Index": 31, "forcible_Robbery_Index": 128, "aggravated_Assault_Index": 100, "burglary_Index": 66, "larceny_Index": 120, "motor_Vehicle_Theft_Index": 104, "crime_Index": 121 }, "airQuality": { "ozone_Index": 115, "lead_Index": 229, "carbon_Monoxide_Index": 94, "nitrogen_Dioxide_Index": 91, "particulate_Matter_Index": 86, "air_Pollution_Index": 114 }, "climate": { "annual_Avg_Temp_Min": 61.36, "annual_Avg_Temp_Max": 82.41, "annual_Avg_Temp": 71.89, "possible_Sunshine_Pct": 64, "sky_Cover_Mean": 6, "clear_Day_Mean": 90, "rainy_Day_Mean": 116, "snow_Day_Mean": 0, "annual_Precip_In": 51.87, "annual_Snowfall_In": 0, "avg_Jan_Low_Temp": 48.63, "avg_Feb_Low_Temp": 50.32, "avg_Mar_Low_Temp": 54.77, "avg_Apr_Low_Temp": 59.41, "avg_May_Low_Temp": 65.32, "avg_Jun_Low_Temp": 70.47, "avg_Jul_Low_Temp": 72.21, "avg_Aug_Low_Temp": 72.41, "avg_Sep_Low_Temp": 71.19, "avg_Oct_Low_Temp": 64.85, "avg_Nov_Low_Temp": 56.35, "avg_Dec_Low_Temp": 50.41, "avg_Jan_High_Temp": 70.92, "avg_Feb_High_Temp": 73.17, "avg_Mar_High_Temp": 77.77, "avg_Apr_High_Temp": 82.67, "avg_May_High_Temp": 87.89, "avg_Jun_High_Temp": 90.46, "avg_Jul_High_Temp": 91.69, "avg_Aug_High_Temp": 91.35, "avg_Sep_High_Temp": 89.2, "avg_Oct_High_Temp": 83.8, "avg_Nov_High_Temp": 77.68, "avg_Dec_High_Temp": 72.37, "avg_Jan_Precip_In": 2.91, "avg_Feb_Precip_In": 2.75, "avg_Mar_Precip_In": 3.71, "avg_Apr_Precip_In": 2.58, "avg_May_Precip_In": 3.73, "avg_Jun_Precip_In": 7.03, "avg_Jul_Precip_In": 7.27, "avg_Aug_Precip_In": 7.35, "avg_Sep_Precip_In": 6.17, "avg_Oct_Precip_In": 3.3, "avg_Nov_Precip_In": 2.58, "avg_Dec_Precip_In": 2.49 }, "naturalDisasters": { "weather_Index": 364, "earthquake_Index": 19, "hail_Index": 29, "hurricane_Index": 508, "tornado_Index": 260, "wind_Index": 79 } } }
Migration Process
The following outlines the series of steps necessary to upgrade applications from previous versions of Community API to Community API V4. It is important these changes be made as soon as possible as the older versions are being deprecated. It is likely that the older versions of Community API endpoints will stop working after June 30, 2023.
Note: There is no Community API V3. We adopted V4 across all ATTOM APIs, some of which had a V3.
- 1
-
Identify calls to Community API
Identify all the places in your code in which a call is made to any of the Community API V2 endpoints: -
- /communityapi/v2.0.0/area/full
- 2
-
Identify calls to other endpoints
Identify any other calls to ATTOM API that might be generating geocoded (geoid) that are used in calls to the Community API.
- 3
-
Change endpoint path
The endpoint paths should be changed to v4 (or higher) and the endpoint name should be mapped to the new name
Original Endpoint V4 Endpoint /communityapi/v2.0.0/area/full v4/neighborhood/community Refer to the documentation for the other APIs to get the new paths used for those endpoints.
Note: The Community Attribute Lookup endpoint is being deprecated. Very few customers are making use of this endpoint. ATTOM recommends using the online data dictionary to get information about the 631 fields now supported by the Community API V4.
- 4
-
Change logic for geocodes
Make all necessary changes to any logic associated with the use of geocodes.
- If geocodes originate from a previous API call, replace the use of geoid with geoIdV4 - See Geocodes
- If geocodes are coming from ATTOM data delivered as a bulk file, ensure you are now receiving the updated file format and adjust the process to include the new geoIdV4 from that source.
- If geocodes are coming from an outside source, a strategy should be developed to replace the old geocodes with the new geocoded. Two new endpoints have been added to assist with this process (Location Lookup and GeoId Legacy Lookup)
- 5
-
Make changes to business logic
With so many fields being added, changed, and deleted, we recommend looking closely at the business logic behind your projects to decide how you wish to leverage the enhancements made. It will be important to ensure you are processing the community data that your project needs in a way that is consistent with how the data is now provided.
A separate spreadsheet is available to assist with making those changes.
The following is a summary of the options provided in the above spreadsheet for each field
Category Action Number of Fields Name Change Only Change logic to extract value from the endpoint using the new field name 66 Field Value Change Change logic and/or display to match the new format of the data 140 County Level Data Make a separate call at the county level to extract the relevant statistics 9 Other Endpoints Make calls to other ATTOM API endpoints to retrieve this data 15 Removed Field No equivalent is available. Evaluate the option of removing data from display or calculations 163 New field Decide if you wish to take advantage (at this time) of the many new fields added. 427 - 6
-
V1.0 Token Upgrade
If your project is using the original V1 Community API, you will need to upgrade the API taken being used to support the new API tokens provided with V2.