Get item data

The data of an item in ArcGIS portal serves as the foundation that supports the item's capability and usability. It provides the underlying geospatial information that supports the item's visualization, analysis, and interactivity.

content management

Create, manage, and access content items using the portal service.

Why get the item data

Fetching the underlying data of an item is a process that allows you to retrieve data in a predetermined format, such as CSV, shapefile, or GeoJSON.

You get the item data to:

Integrate the data into your custom workflows, applications, and analyses.
Perform data analysis and visualization in external systems.
Maintain data consistency across different platforms and systems.
Ensure users can access and work with the data using their preferred custom tools and software.

How to get the item data

The general steps of getting the item data:

1. Choose a type of authentication
Select a type of authentication to get an access token to access your content.
2. Get an access token
Get an access token to access content in ArcGIS portal.
3. Get the item data
Get the item and its data by using the item ID.

1. Choose a type of authentication

The purpose of an access token in ArcGIS is to provide secure, authorized access to content items, services, and functionality for both applications and users. You need to implement a type of authentication in your app to get an access token and access secure ArcGIS resources. The type of authentication you implement will determine the access privileges and billing method of your app.

The following types of authentication can be used to get an access token:

API key authentication
User authentication
App authentication

2. Get an access token

To get an access token, you need to implement a type of authentication in your application. Different types of authentication result in access tokens with different privileges. Learn how to implement the types of authentication workflows below:

3. Get the item data

Once you have an access token, you can access an item and its properties by the item ID.

Example

The underlying data of an item is typically stored as text (JSON) or as a reference to services, files, or other resources. The examples below shows how to get the item data from a public and private web map.

The public example shows how to get the data for a public web map item.
The private example gets the child data for an item that you own. The data returned is the JSON.

APIs

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS API for PythonArcGIS REST JS
Use dark colors for code blocksCopy
  const item = new PortalItem({
    portal: "https://www.arcgis.com/sharing/rest",
    id: "5a5147abe878444cbac68dea9f2f64e7"
  });
  item.load().then(()=>{
    item.fetchData().then((response)=>{
      console.log(response);
    });
  });

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS API for PythonArcGIS REST JS
Use dark colors for code blocksCopy
const portal = new Portal({
  url: "https://www.arcgis.com/",
  authMode: "immediate"
});

// OR
esriConfig.apiKey = "YOUR_ACCESS_TOKEN"

const portalItem = new PortalItem({
  portal: portal,
  id: "ITEM_ID" // private
});
portalItem.load().then(()=>{
  portalItem.fetchData().then((response)=>{
    console.log(response);
  });
});

REST API

cURL

HTTP

Use dark colors for code blocks

Copy

1
2
3
4
5
6
7
8
9
10
## Public

curl https://www.arcgis.com/sharing/rest/content/items/5a5147abe878444cbac68dea9f2f64e7/data \
-d 'f=pjson'

## Private

curl https://www.arcgis.com/sharing/rest/content/items/<ITEM_ID>/data \
-d 'f=pjson' \
-d 'token=<ACCESS_TOKEN>'

Run in Postman

Use dark colors for code blocksCopy
// Public

{
  "operationalLayers":[
     {
        "id":"Seven_Natural_Wonders_of_the_World_6051",
        "layerType":"ArcGISFeatureLayer",
        "url":"https://services.arcgis.com/uCXeTVveQzP4IIcx/arcgis/rest/services/Seven_Natual_Wonders_of_the_World/FeatureServer/0",
        "visibility":true,
        "opacity":1,
        "title":"Seven Natural Wonders of the World",
        "itemId":"da7cda8d38224b368bc74cc7d6f05d0f"
     }
  ],
  "baseMap":{
     "baseMapLayer":[
        {
           "id":"defaultBasemap",
           "layerType":"ArcGISTiledMapServiceLayer",
           "url":"https://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer",
           "visibility":true,
           "opacity":1,
           "itle":"Topographic"
        }
     ],
     "title":"Topographic"
  },
  "spatialReference":{
     "wkid":102100,
     "latestWkid":3857
  },
  "authoringApp":"WebMapViewer",
  "authoringAppVersion":"5.4",
  "version":"2.11"
}

// Private

{
   "operationalLayers":[
      {
         "id":"",
         "layerType":"",
         "url": "ITEM_URL"
         "visibility":true,
         "opacity":1,
         "title":"YOUR_ITEM_TITLE",
         "itemId":"ITEM_ID"
      }
   ],
   "baseMap":{
      "baseMapLayer":[
         {
            "id":"defaultBasemap",
            "layerType":"ArcGISTiledMapServiceLayer",
            "url":"https://services.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer",
            "visibility":true,
            "opacity":1,
            "itle":"TILE"
         }
      ],
      "title":"BASEMAP_TITLE"
   },
   "spatialReference":{
      "wkid":102100,
      "latestWkid":3857
   },
   "authoringApp":"WebMapViewer",
   "authoringAppVersion":"5.4",
   "version":"2.11"
 }

Code examples

Get the item data using item ID

Below is an example that demonstrates how get an item using item ID and list the underlying data.

ArcGIS Maps SDK for JavaScriptArcGIS Maps SDK for JavaScriptArcGIS API for PythonArcGIS REST JS
Expand
Use dark colors for code blocksCopy
        portalItem.fetchData().then(function(data) {
          const features = data.value.features;
          const dataList = document.getElementById("dataList");
          // Populate a list with feature attributes
          features.forEach(function(feature) {
            const attributes = feature.attributes;
            const li = document.createElement("li");
            li.textContent = JSON.stringify(attributes);
            dataList.appendChild(li);
          });
Expand

Tutorials

Import data to create a feature layer

Use data management tools to import files and create a feature layer in a feature service.

ArcGIS portal

Define a new feature layer

Use data management tools to define and create a new empty feature layer in a feature service.

ArcGIS portal Python API REST JS

Manage a feature layer

Use a hosted feature layer item to set the properties and settings of a feature layer in a feature service.

ArcGIS portal

Create a vector tile service

Use data management tools to create a new vector tile service from a feature service.

ArcGIS portal

Create a map tile service

Use ArcGIS Online or scripting APIs to publish a map tile service.

ArcGIS Portal Python API REST JS

Services

Feature service

Add, update, delete, and query feature data.

Vector tile service

Store and access vector tile data.

Map tile service

Store and access map tile data.

Image service

Store and access imagery and raster data.

API support

Use data management tools or Client APIs to create, manage, and access data services. The table below outlines the level of support for each API.

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

Full supportPartial supportNo support

1. Use portal class and direct REST API requests
2. Access via ArcGIS REST JS
3. Requires manually setting styles for renderers

Tools

Portal

Create, manage, and access content and data services for applications.

Map Viewer

Create, explore, and share web maps for 2D applications.