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.	`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
Go to tutorial

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.

JavaScript Maps SDK Esri Leaflet MapLibre GL JS OpenLayers CesiumJS REST JS Python API REST API