The Hub Feed API lets you programmatically filter Hub feeds from an ArcGIS Hub catalog by using simple query methods. Catalog feeds allow interoperability between data catalogs and can increase discovery through search engines and third-party catalogs.
Federating means that your datasets can be discovered on other open data platforms that ingest your catalog feed and link to your data source. This allows users of other platforms to access the original data from your Hub catalog.
For further details including definitions and example use cases, see Federate data and manage catalog feeds.
Use-cases
Some of the broad use-cases of the Feeds API are as follows:
- Retrieve DCAT feeds in multiple versions for open data catalog compliance
- Filter feeds by item id, date, or free text query
- See content updated within the last 24 hours
- Retrieve RSS feeds for content updates and syndication
- Federate Hub data with external catalogs and portals
Endpoints
The following feed endpoints are available to access and syndicate publicly shared content from your Hub site in standardized formats.
DCAT feeds
Using DCAT to describe Hub catalog content can increase discoverability and allow applications to access metadata from multiple catalogs. It also enables federated dataset search across catalogs.
DCAT AP
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/feed/dcat-ap/2.0.1 | Retrieve a DCAT AP 2.0.1 feed. |
| GET | /api/feed/dcat-ap/2.1.1 | Retrieve a DCAT AP 2.1.1 feed. |
| GET | /api/feed/dcat-ap/3.0.0 | Retrieve a DCAT AP 3.0.0 feed. |
DCAT US
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/feed/dcat-us/1.1 | Retrieve a DCAT US 1.1 feed, used for federating with Data.gov. |
| GET | /api/feed/dcat-us/3.0 | Retrieve a DCAT US 3.0 feed, used for federating with Data.gov. |
Really Simple Syndication (RSS)
RSS is a web feed format used to publish frequently updated content in a standardized way, allowing users to automatically subscribe and receive updates. RSS feeds contain high-level metadata such as title, description, and publication date for all publicly available content shared to the site. Hub conforms to the GeoRSS specification.
| Method | Endpoint | Description |
|---|---|---|
| GET | /api/feed/rss/2.0 | Retrieve an RSS 2.0 feed for content updates and syndication. |
Authentication
When a site has feeds enabled, no authentication is required. The feeds are publicly accessible. If feeds are disabled they will not be available and an error message will be showm from the API.