Skip To Content


The Geoportal REST interface follows the design of the ArcGIS Server REST API. Through the REST API, it is possible to query the locally-hosted resources, and also resources hosted on remote repositories. These two scenarios are shown below with placeholders for the REST parameters.

  • To query the local geoportal catalog only, use the following URL pattern: http://<hostName>/geoportal/rest/find/document?<requestParameter>
  • To query remote repositories, use the following URL pattern: http://<hostName>/geoportal/rest/distributed?rid=<repositoryID>&<requestParameters>. In this example, rid is used to specify the ID of the repository to search.

You can use multiple rid parameters to search multiple repositories at the same with the following URL pattern: http://<hostName>/geoportal/rest/distributed?rid=<repositoryID1>&rid=<repositoryID2>&<requestParameter>. For example http://<hostName>/geoportal/rest/distributed?rid=local&rid=ArcGIS.COM&start=1&max=10&orderBy=relevance&searchText=water&f=atom.

The following table lists the parameters that are available in the Geoportal REST API. For a full description of each parameter, refer to the com.esri.gpt.control.georss and packages in the Geoportal JavaDoc. For requests that have more than one parameter, the parameters must be concatenated using an ampersand (&), for example, http://<hostName>/geoportal/rest/find/document?<requestParameter1>&<requestParameter2>&....

requestParameterFunctionAccepted Values


Query by extent specified as two pairs of coordinates (west-south and east-north)

Comma-delimited string of integers between -180,180 and -90, 90.


Query by spatial relationship. Used in conjunction with bbox parameter.

String value. One of esriSpatialRelWithin (default), esriSpatialRelOverlaps.


Query by keyword

String value representing a keyword.


Keyword concatenation options. This parameter is obsolete with the Lucene syntax.

For an exact match use double quotes. For example, see the syntax for two terms, Hawaii and quads:

  • Exact: "Hawaii quads"
  • Any: Hawaii quads
  • All: +Hawaii+quads
http://<hostName>/geoportal/rest/find/document?searchText="Hawaii quads"&f=georss


Query by content type

String value representing an ESRI content type. See the Geoportal JavaDoc for a complete list.


Query by data category (ISO 19115 themes)

Comma-delimited list of strings. Keywords identified by the ISO 19115 specification. See the Geoportal JavaDoc for a complete list.

after, before

Query by date

Date string in the format yyyy-mm-dd.


Result sort options

String value. One of areaAscending, areaDescending, dateAscending, dateDescending (default), format, relevance, title.


Specify max number of records to retrieve.

Integer. There is a limit of max=100 on unqualified queries. An unqualified query is when there are no search parameters set. The limit on qualified queries is max=5000. The default is 10.


Defines how spatial data will be represented.

String value. One of esriGeometryPoint, esriGeometryPolygon (default), esriGeometryBox.


the response format

String value. One of georss (default), atom, json, kml, html, htmlfragment, or csv (starting at version 1.2).


CSS stylesheet for HTML results

String value representing a URL to a stylesheet.


Behavior of links (open in same or new window).

String value. One of blank (default), parent, self, top.


Id associated with the repository. Multiple rid parameters are allowed for comparing results between different repositories

String value.


Comma Delimited rid. Can be used instead of the multiple ridparameters.

String values.


Maximum amount of time allowed to retrieve results.

Integer. The default is 5000 milliseconds.