Skip To Content

listings: Listings Search

Example usage

URL for Listings Search:

https://www.arcgis.com/sharing/rest/content/listings?q=park

Description

This operation searches for marketplace listings. The searches are performed against a high performance index that indexes the most popular fields of a listing. See the Search reference page for information on the fields and the syntax of the query.

By default, this search spans all public listings in the marketplace. However, if you're logged in as a vendor org admin and you specify the mylistings=true parameter, it then searches all public and private listings in your organization.

Request parameters

ParameterDetails
[Common Parameters]

For a complete listing, see Common parameters.

q

Description: The query string to use to search.

See Search reference.

Example: q=redlands+map

mylistings

Description: If true and you're logged in as a vendor org admin, it searches all public and private listings in your organization. Note that if mylistings=true, the q parameter is optional.

Values: false (default) | true

start

Description: The number of the first entry in the result set response. The index number is 1-based.

The default value of start is 1. (i.e., the first search result).

The start parameter, along with the num parameter, can be used to paginate the search results.

Example: start=11 (Returns result #11 as the first entry in the response.)

num

Description: The maximum number of results to be included in the result set response.

The default value is 10, and the maximum allowed value is 100.

The start parameter, along with the num parameter, can be used to paginate the search results.

Note that the actual number of returned results may be less than num. This happens when the number of results remaining after start is less than num.

Example: num=50 (Returns a max of 50 results in the response.)

sortField

Description: The field to sort by. You can also sort by multiple fields (comma separated) for listings, sort field names are case-insensitive.

Supported sort field names are title, created, listingpublisheddate, type, owner, avgrating, numratings, numcomments, and numviews.

sortOrder

Description: Describes whether the order returns in ascending or descending order. Default is ascending.

Values: asc | desc

Response properties

PropertyDetails
q

Description: The query string searched.

total

Description: The total number of results found for the whole query. The number of query results is limited to 10000.

start

Description: The number of the first entry in the result set for this response. The index number is 1-based.

num

Description: The number of results included in the result set for this response.

nextStart

Description: The next entry index if the current result set doesn't contain all results.

listings

Description: A JSON array of listing objects. See the response properties of a listing.

JSON response syntax

{
  "query": "<query string>",
  "total": <total number of results>,
  "start": <results in first set>,
  "num": <number of results per page>,
  "nextStart": <result number of next page>,
  "listings": [
    {<listing1>},
    {<listing2>}
  ]
}

JSON response example

{
  "query": "test",
  "total": 1,
  "start": 1,
  "num": 1,
  "nextStart": -1,
  "listings": [
    {
      "itemId": "c23d34bea01946f0ba1f530dda4c142e",
      "licenseType": "free",
      "priceDesc": "Free",
      "creditsPerTransaction": 0,
      "listingAccess": "public",
      "trialSupported": false,
      "type": "Feature Service",
      "typeKeywords": [
        "Feature Service",
        "Hosted Service"
      ],
      "title": "Test Title",
      "description": "Test Description",
      "tags": [
        "test",
        "tag"
      ],
      "snippet": "Test Snippet",
      "thumbnail": "thumbnail/usa_counties.jpg",
      "appCategories": [],
      "industries": [],
      "languages": [],
      "largeThumbnail": "largethumbnail/pic.png",
      "banner": "banner/banner_data.jpg",
      "screenshots": ["screenshots/ss1.jpg"],
      "owner": "esri",
      "created": 1369959407000,
      "avgRating": 3.75,
      "numComments": 2,
      "numRatings": 7,
      "listingPublishedDate": 1503949100000,
      "vendor": {
        "id": "VLx4vrvwONglS8iz",
        "name": "Test Vendor Name",
        "description": "Test Vendor Description",
        "thumbnail": "thumbnail.png"
      }
    }
  ]
}