Global data search

Map showing coverage of global data.

What is a global data search?

You can retrieve global demographic data, also known as standard demographics, for 170 countries and regions. The data include population, income, age, households, education, spending, jobs, marital status, and key facts.

How to access the data

To get standard demographic data using the enrich operation, you use the KeyGlobalFacts data collection. This is provided for you by default if you do not provide a data collection for the enrich operation.

The KeyGlobalFacts data collection contains the following data variables, which will populated when you run the request:

Data variable	Description	Examples
`TOTPOP`	Total population	619
`TOTHH`	Total households	354
`AVGHHSZ`	Average household size	1.75
`MALES`	Total male population	292
`FEMALES`	Total female population	328

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 global facts (1 mile buffer)

Use the GeoEnrichment service to enrich a 1 mile ring buffer using the only required parameter, studyAreas. With the search box, select a pre-defined location or click on the map to submit a point and create a 1 mile ring buffer. Facts are returned from the default data collection, Key Global Facts. Key Global facts contains five analysis variables that are tabulated for all countries and regions.

Steps

Reference the service.
Define studyAreas to submit a point.
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 } }],
              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
curl https://geoenrich.arcgis.com/arcgis/rest/services/World/geoenrichmentserver/Geoenrichment/enrich? \
-d "studyAreas=[{'geometry':{'x': -117.1956, 'y': 34.0572}}]"
-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

Tutorials

Query demographic data

Query demographic information for locations around the world with the GeoEnrichment service.

Enrich data sources

Enrich data with demographic information and local business facts using the spatial analysis service.

Find data using analysis variables

Learn how to use the Analysis Variable Finder to get enrichment data.

Analysis Variable Finder

Find data using data collections

Learn how to use the Data Collection Finder to get enrichment data.

Data Collection Finder

Services

GeoEnrichment service

Find facts and demographic information about a location or area.

API support

	GeoEnrichment
ArcGIS Maps SDK for JavaScript	¹
ArcGIS Maps SDK for .NET	²
ArcGIS Maps SDK for Kotlin	²
ArcGIS Maps SDK for Swift	²
ArcGIS Maps SDK for Java	²
ArcGIS Maps SDK for Qt	²
ArcGIS API for Python
ArcGIS REST JS	³
Esri Leaflet	⁴
MapLibre GL JS	⁴
OpenLayers	⁴

Full supportPartial supportNo support

1. Access via ArcGIS REST JS or use a task.
2. Access via HTTP request.
3. Access via HTTP request and authentication.
4. Access via ArcGIS REST JS.

Tools

Analysis Variable Finder

Find analysis variables available in the GeoEnrichment service.

Data Collection Finder

Find data collections available in the GeoEnrichment service.

Mapping APIs and location services

Global data search

Was this page helpful?

Was this page helpful?