What is a local data search?
You can retrieve local data, also known as advanced demographics, to get detailed information for specific countries, counties, cities, and locations. Each individual data field is represented by an analysis variable, and analysis variables are organized into data categories that you can explore interactively with the Analysis Variable Finder and Data Collection Finder.
How to access the data
To get advanced demographics data, you use the enrich
operation and specify the analysis
or data
you want returned.
Below is a list of the high-level data categories that are available. You can use analysis variables or data collections within these categories to get data.
Data category | Description | Data collection examples | Analysis variable examples |
---|---|---|---|
Population | In depth information on household and family composition variables such as language spoken and religious affiliation. Population counts, density, gender, and distribution available globally. | Population | 2021 Population in Family Households , 2021 Civilian Employed Population Age 16+ |
Income | In depth information on income, savings, and poverty statistics. General information, including purchasing power, is available globally. | Net Worth | 2023 Median Disposable Income , 2021 Households Receiving Food Stamps/ |
Age | In depth information on age distribution for population, households, and income. General age information can be found globally. | Age By Sex By Race | 2023 Senior Population ( , 2028 Child Population ( |
Households | In depth information on households including age and immigration status. General information, such as total number of households, is available globally. | Presence of Children | 2021 Households with 1+ Persons with a Disability , 2010 Family Households |
Housing | Information on housing structures, including vacant units, rent, and mortgage status. | Home Value | 2023 Average Home Value , 2023 Renter Occupied Housing Units , 2021 H , |
Health | Information on the health-care industry and people's relationship to it. | Health | 2028 Health Insurance , 2028 Medical Care |
Education | Information about current or previous levels of education. | Education , Educational Attainment | 2023 Education , 2023 Educational Attainment Base |
Business | Corporate information, including sale figures and the number of businesses by type. | Businesses | Total ( , Total ( , Construction ( |
Race or Ethnicity | Information on racial demographics. | Population by Race | Diversity Index , Hispanic Population Age 18+ , Pop by Language Spoken at Home |
Retail and Centrality** | Information on retail sectors, purchasing power, and turnover rates. | Retailand | 2021 Retail Purchasing Power , 2021 Turnover Key Figures per Inhabitant |
Spending | Information on expenditures in specific retail categories. | Spending Facts | Retail Goods ( , Restaurant( |
Behaviors | Information on expected consumer demand and activities. | Electronics & Internet | 2023 Households by Tapestry Segment Base |
Psychographics* | Information on consumer motivations and preferences. | Psychographics & Advertising | 2023 Seen Video Ad at Gas Station Last 30 Days , 2023 Helping to Preserve Nature |
Jobs | Information on employment status. | Occupation | 2023 Occupation |
Poverty | Information on educational attainment, income, food stamps, employment, and race. | Food Stams/ | 2021 Households Receiving Food Stamps/ |
Marital Status | Information on marital status. | Marital Status Totals | 2023 Population Age 15+ |
Language-Immigration | Information about language spoken at home, country of birth, aboriginal identity, and minority status. | Language | 2021 Pop Age 5+ by Language Spoken at Home Base |
Market Segmentation | Identifies regional demographic similarities using market surveys. | Life | 2023 Upscale Avenues Tapestry Life |
At Risk | Information about populations considered to be socioeconomically, or due to public policy, at risk. | At Risk | 2023 H |
Key Facts | Contains the most popular demographic data categories for each country. | Key U | 2023 Daytime Population |
Policy* | Information related to public policy decisions. | Policy Facts | 2023 Per Capita Income |
Crime* | Information on the regional rate of risk for specific crimes. | Crime Indexes | 2023 Total Crime Aggregate |
*USA Only **Germany Only
URL request
Learn more about standard and enhanced endpoints in Service endpoints.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich?<parameters>
Required parameters
Name | Description | Examples |
---|---|---|
f | The format of the data returned. | f=json f=pjson f=geojson f=csv |
token | An API key or OAuth 2.0 access token. | token= |
study | The input point, address, line, polygon or administrative boundary | study study study |
Key parameters
Name | Description | Examples |
---|---|---|
analysis | Returns a subset of attributes from one or more data collections. | ["food. |
data | Returns a preassembled list of analysis variables curated for specific countries and regions. | [educationalattainment] |
return | Retrieves the study area's geometry for display on a map. | true , false |
Additional parameters:
The add
returns percent, average and index attributes. The intersecting
parameter returns information about administrative boundaries intersected by an input point. The use
parameter provides a performance hint to the service when all input study areas lie within the same country or region.
Code examples
Find local facts (1 mile buffer)
In this example, the data
parameter is used to return a different set of facts. With the search box, select a pre-defined location or click on the map to create a 1 mile ring buffer around a point. Facts are returned from the requested data collection, Household Totals.
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/datacollections/US?f=pjson
Steps
-
Reference the service.
-
Define
study
to submit a point.Areas -
Define
data
to return a curated list of facts.Collections -
Set the API key.
APIs
function getDemographicData(point, dataCollection) {
if (!dataCollection) {
return;
}
// Request demographic data
arcgisRest.queryDemographicData({
studyAreas: [{ "geometry": { "x": point.longitude, "y": point.latitude } }],
authentication: authentication,
dataCollections: [dataCollection]
})
.then((response) => {
if (response.results[0].value.FeatureSet.length > 0 &&
response.results[0].value.FeatureSet[0].features.length > 0) {
const attributes = response.results[0].value.FeatureSet[0].features[0].attributes;
showData(attributes, point, dataCollection);
} else {
console.log("No data found or point not in the United States.");
}
});
}
REST API
curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': -74.0060, 'y': 40.7128}}]" \
-d "dataCollections=[educationalattainment]" \
-d "f=json" \
-d "token=<ACCESS_TOKEN>"
Find facts for a 5 minute drive area
In this example, the study
parameter is used to define a 5 minute drive time service area instead of the default 1 mile ring buffer. Select a data collection then click on the map to show data within a 5 minute drive area.
Steps
-
Reference the service.
-
Define
study
to submit a point.Areas -
Define
study
to create a drive time service area around the point.Areas Options -
Define
data
to return a specific lists of variables.Collections -
Define
return
as true so the service area can be displayed on the map.Geometry -
Set the API key.
APIs
function getDemographicData(point, dataCollection) {
if (!dataCollection) {
return;
}
// Request demographic data
arcgisRest.queryDemographicData({
studyAreas: [{ "geometry": { "x": point.longitude, "y": point.latitude } }],
authentication: authentication,
dataCollections: [dataCollection],
params: {"studyareasoptions": '{"areaType": "NetworkServiceArea", "bufferUnits": "Minutes", "bufferRadii": [5], "travel_mode": "Driving"}'},
returnGeometry: true
})
.then((response) => {
if (response.results[0].value.FeatureSet.length > 0 &&
response.results[0].value.FeatureSet[0].features.length > 0) {
const attributes = response.results[0].value.FeatureSet[0].features[0].attributes;
const geometry = response.results[0].value.FeatureSet[0].features[0].geometry;
drawGeometry(geometry);
showData(attributes, point, dataCollection);
} else {
console.log("No data found.");
}
});
}
REST API
curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': -74.0060, 'y': 40.7128}}]" \
-d "studyAreasOptions={'areaType': 'NetworkServiceArea', 'bufferUnits': 'Minutes', 'bufferRadii': [10],'travel_mode': 'Driving'}" \
-d "dataCollections=HouseholdTotals" \
-d "returnGeometry=true" \
-d "f=json" \
-d "token=<ACCESS_TOKEN>"
Find normalized facts for a 1 mile buffer
In this example the add
parameter is used to calculate percentages from facts. Use the search box to select a pre-defined location or click on the map to create the default 1 mile ring around a point. The add
parameter is set to percent
. The list of accepted values are percent
, index
, average
, all
.
Steps
-
Reference the service.
-
Define the
study
Areas -
Define the
data
Collections -
Define
add
to return averagesDerivative Variables -
Set the API key.
APIs
function getDemographicData(point) {
// Request demographic data
arcgisRest.queryDemographicData({
studyAreas: [{ "geometry": { "x": point.longitude, "y": point.latitude } }],
dataCollections: ["Health"],
addderivativevariables: ["average"],
authentication: authentication
})
.then((response) => {
if (response.results[0].value.FeatureSet.length > 0 &&
response.results[0].value.FeatureSet[0].features.length > 0) {
const attributes = response.results[0].value.FeatureSet[0].features[0].attributes;
showData(attributes, point);
} else {
console.log("No data found.");
}
});
}
REST API
curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': -74.0060, 'y': 40.7128}}]" \
-d "dataCollections=Health" \
-d "addDerivativeVariables=average" \
-d "f=json" \
-d "token=<ACCESS_TOKEN>"
Tutorials
Get local data
Query local analysis variables in select countries around the world with the GeoEnrichment service.