Search for an item

Searching for content is discovering resources available in your organization. By using the search capability, you can locate maps, layers, data, and other items that are pertinent to your needs. The search results are determined by keywords, tags, and metadata associated with each item making it important to understand how to use these item properties to find content. Tagging and describing your own items is also important to allow users to discover and use your work.

Where to search for items

You can search for items from various data sources including:

Why search for items

You search for items to:

• Quickly locate relevant spatial datasets, maps, applications, and resources.
• Find specific content without manual browsing through folders or categories.
• Use existing content saving time and effort in creating new maps, layers, and applications.
• Share and access content across teams, departments, and organizations within ArcGIS Online.
• Incorporate search results into workflows, applications, and analyses seamlessly.

How to search for an item

The general steps of searching for an item:

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:

• API key authentication.
• User authentication.
• App authentication.

3. Search for the item

Once you have an access token, you can perform the search operation for an item.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
const portal = new Portal({
  url: "https://www.arcgis.com/"
});
portal.load().then(()=>{
  const query = {
    query: "title: Seven Natural Wonders, type: web map, owner: esri_devlabs"
  };
  portal.queryItems(query).then((response)=>{
    console.log(response);
  });
});

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
const portal = new Portal({
  url: "https://www.arcgis.com/",
  authMode = "immediate"
});
portal.load().then(()=>{
  const query = {
    query: `type: web map, owner: ${portal.user.username}`
  };
  portal.queryItems(query).then((response)=>{
    console.log(response);
  });
});

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

curl https://www.arcgis.com/sharing/rest/search \
-d 'q=title:"Seven Natural Wonders of the World" AND type:"web map" AND owner:"esri_devlabs"' \
-d 'f=pjson'

## Private

curl https://www.arcgis.com/sharing/rest/search \
-d 'q=title:"Seven Natural Wonders of the World" AND type:"web map" AND owner:"<YOUR_USER_ID>"' \
-d 'f=pjson'
-d 'token=<ACCESS_TOKEN>'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
{
  "query": "title:\"Seven Natural Wonders of the World\" AND type:\"web map\" AND owner:\"esri_devlabs\"",
  "total": 1,
  "start": 1,
  "num": 10,
  "nextStart": -1,
  "results": [{
    "id": "5a5147abe878444cbac68dea9f2f64e7",
    "owner": "esri_devlabs",
    "created": 1569537110000,

Code examples

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
    portal = new Portal(); // Default is "https://www.arcgis.com/sharing/rest"
    portal.load().then(()=>{
      var queryParams = new PortalQueryParams({
        query: "CreationDate < '2022-01-01'"
      });

      portal.queryItems(query).then((response)=>{
        // Log the items older than Jan 1, 2022
        console.log("Items older than January 1, 2022:");
        result.results.forEach(function (item) {
          console.log(item.title);
        });
      });
    });

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
      // Query parameters
      var queryParams = new PortalQueryParams({
        query: "title LIKE '%Wetlands%' AND type = 'Feature Service'"
      });

      // Query portal items
      portal.queryItems(queryParams).then(function(queryResult) {
        // Display item titles in console
        queryResult.results.forEach(function(item) {
          console.log(item.title);
        });

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 portalPython APIREST 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 portalPython APIREST JS

Create a map tile service

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

ArcGIS portalPython APIREST JS

Services

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.

Tools