Local data search

Map showing coverage of local data.

What is a local data search?

You can retrieve local data, also known as advanced demographics, which provides additional 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 analysisVariables or dataCollections 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`	`2020 Population in Family Households`, `2020 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`	`2022 Median Disposable Income`, `2020 Households Receiving Food Stamps/SNAP`
Age	In depth information on age distribution for population, households, and income. General age information can be found globally.	`Age By Sex By Race`	`2022 Senior Population (Age 65+)`, `2027 Child Population (Age <18)`
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`	`2020 Households with 1+ Persons with a Disability`, `2010 Family Households: 4-Person`
Housing	Information on housing structures, including vacant units, rent, and mortgage status.	`Home Value`	`2022 Average Home Value`, `2022 Renter Occupied Housing Units`, `2020 HHs by Heating Fuel: Utility Gas`,
Health	Information on the health-care industry and people's relationship to it.	`Health`	`2027 Health Insurance`, `2027 Medical Care`
Education	Information about current or previous levels of education.	`Education`, `Educational Attainment`	`2022 Education`, `2022 Educational Attainment Base`
Business	Corporate information, including sale figures and the number of businesses by type.	`Businesses`	`Total (NAICS11-99) Businesses`, `Total (SIC01-99) Sales ($000)`, `Construction (SIC15-17) Employees`
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.	`RetailandCentralityNexiga`	`2021 Retail Purchasing Power`, `2021 Turnover Key Figures per Inhabitant`
Spending	Information on expenditures in specific retail categories.	`Spending Facts`	`Retail Goods (Monthly)`, `Restaurant(Monthly)`
Behaviors	Information on expected consumer demand and activities.	`Electronics & Internet`	`2022 Households by Tapestry Segment Base`
Psychographics*	Information on consumer motivations and preferences.	`Psychographics & Advertising`	`2022 Seen Video Ad at Gas Station Last 30 Days`, `2022 Helping to Preserve Nature`
Jobs	Information on employment status.	`Occupation`	`2022 Occupation: Construction/Extraction REL`
Poverty	Information on educational attainment, income, food stamps, employment, and race.	`Food Stams/SNAP`	`2020 Households Receiving Food Stamps/SNAP`
Marital Status	Information on maritial status.	`Marital Status Totals`	`2022 Population Age 15+: Never Married`
Language-Immigration	Information about language spoken at home, country of birth, aboriginal identity, and minority status.	`Language`	`2020 Pop Age 5+ by Language Spoken at Home Base`
Market Segmentation	Identifies regional demographic similarities using market surveys.	`LifeMode Groups`	`2022 Upscale Avenues Tapestry LifeMode Group L2 Households`
At Risk	Information about populations considered to be socioeconomically, or due to public policiy, at risk.	`At Risk`	`2022 HH Owns or Leases Any Vehicle`
Key Facts	Contains the most popular demographic data categories for each country.	`Key US Facts`	`2022 Daytime Population`
Policy*	Information related to public policy decisions.	`Policy Facts`	`2022 Per Capita Income`
Crime*	Infromation on the regional rate of risk for specific crimes.	`Crime Indexes`	`2022 Total Crime Aggregate`

*USA Only **Germany Only

URL request

Learn more about standard and enhanced endpoints in Service endpoints.

Use dark colors for code blocksCopy
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. Learn how to get an access token in Security and authentication.	`token=<YOUR_API_KEY>` `token=<ACCESS_TOKEN>`
`studyAreas`	The input point, address, line, polygon or administrative boundary	`studyAreas=[{"geometry":{"x": -122.435, "y": 37.785}}]` `studyAreas=[{"address":{"text":"380 New York St. Redlands, CA 92373"}}]` `studyAreas=[{"sourceCountry":"US","layer":"US.ZIP5","ids":["92373"]}]`

Key parameters

Name	Description	Examples
`analysisVariables`	Returns a subset of attributes from one or more data collections.	`["food.X1131_X"]`
`dataCollections`	Returns a preassembled list of analysis variables curated for specific countries and regions.	`[educationalattainment]`
`returnGeometry`	Retrieves the study area's geometry for display on a map.	`true`, `false`

Additional parameters: The addDerivativeVariables returns percent, average and index attributes. The intersectingGeographies parameter returns information about administrative boundaries intersected by an input point. The useData 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 dataCollections 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.

Use dark colors for code blocksCopy
https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/datacollections/US?f=pjson

Steps

Reference the service.
Define studyAreas to submit a point.
Define dataCollections to return a curated list of facts.
Set the API key.

APIs

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS API for PythonArcGIS REST JSEsri LeafletMapLibre GL JSOpenLayersCesiumJS
Expand
Use dark colors for code blocksCopy
        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.");
              }
            });
        }
Expand

REST API

cURL

HTTP

Use dark colors for code blocks

Copy

1
2
3
4
5
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>"

Run in Postman

Use dark colors for code blocksCopy
{
  "results" : [ {
    "paramName" : "GeoEnrichmentResult",
    "dataType" : "GeoEnrichmentResult",
    "value" : {
      "version" : "2.0",
      "FeatureSet" : [ {
        "displayFieldName" : "",
        "fieldAliases" : {
          "ID" : "Id",
          "OBJECTID" : "Object ID",
          "sourceCountry" : "Country code",
          "areaType" : "Area type",
Expand

Find facts for a 5 minute drive area

In this example, the studyAreasOptions 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 studyAreas to submit a point.
Define studyAreasOptions to create a drive time service area around the point.
Define dataCollections to return a specific lists of variables.
Define returnGeometry as true so the service area can be displayed on the map.
Set the API key.

APIs

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptEsri LeafletMapLibre GL JSOpenLayersCesiumJS
Expand
Use dark colors for code blocksCopy
        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.");
              }
            });
        }
Expand

REST API

cURL

HTTP

Use dark colors for code blocks

Copy

1
2
3
4
5
6
7
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>"

Run in Postman

Use dark colors for code blocksCopy
{
  "results" : [ {
    "paramName" : "GeoEnrichmentResult",
    "dataType" : "GeoEnrichmentResult",
    "value" : {
      "version" : "2.0",
      "FeatureSet" : [ {
        "displayFieldName" : "",
        "fieldAliases" : {
          "ID" : "Id",
          "OBJECTID" : "Object ID",
          "sourceCountry" : "Country code",
          "areaType" : "Area type",
Expand

Find normalized facts for a 1 mile buffer

In this example the addDerivativeVariables 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 addDerivativeVariables parameter is set to percent. The list of accepted values are percent, index, average, all.

Steps

Reference the service.
Define the studyAreas
Define the dataCollections
Define addDerivativeVariables to return averages
Set the API key.

APIs

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS API for PythonArcGIS REST JSEsri LeafletMapLibre GL JSOpenLayersCesiumJS
Expand
Use dark colors for code blocksCopy
        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.");
              }
            });
        }
Expand

REST API

cURL

HTTP

Use dark colors for code blocks

Copy

1
2
3
4
5
6
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>"

Run in Postman

Use dark colors for code blocks

Copy

Mapping APIs and location services

Local data search

What is a local data search?

How to access the data

URL request

Required parameters

Key parameters

Code examples

Find local facts (1 mile buffer)

Steps

APIs

REST API

Find facts for a 5 minute drive area

Steps

APIs

REST API

Find normalized facts for a 1 mile buffer

Steps

APIs

REST API