Skip to main content

How to consume the Catalogue Service for the Web (CSW) API on WEkEO?

This article will show you the endpoint of WEkEO CSW API and the different operations you can use to retrieve metadata information.

David Bina avatar
Written by David Bina
Updated over 3 weeks ago

Context


Catalogue Service for the Web (CSW) is a standard for providing metadata about geospatial data and services on internet. It allows users to discover and access geospatial resources such as maps, satellite imagery and other data, through a searchable online catalog.

WEkEO Dataset Catalogue is exposed as OGC CSW service via this endpoint:

https://gateway.prod.wekeo2.eu/elastic-csw/service

Here are the operations you can use via the CSW API on WEkEO:

πŸ“Œ Note: to get more information about CSW, we invite you to check the standard OGC documentation.

CSW operations


GetCapabilities

The GetCapabilities operation allows CSW clients to retrieve a service metadata from a server. The response to a GetCapabilities request is an XML document containing service metadata about the server:

https://gateway.prod.wekeo2.eu/elastic-csw/service?service=CSW&version=2.0.2&request=GetCapabilities

GetRecords

The GetRecords operation is used to search the catalog and retrieve metadata records that match a specific search criteria. It can also be used to paginate through large result sets.

Following a few examples on how to use GetRecords.

Get the basic metadata of first 100 datasets (including IDs)

https://gateway.prod.wekeo2.eu/elastic-csw/service?service=CSW&request=GetRecords&version=2.0.2&ElementSetName=brief&resultType=results&maxRecords=100

Get the detailed metadata of first 100 datasets (including IDs)

https://gateway.prod.wekeo2.eu/elastic-csw/service?service=CSW&request=GetRecords&version=2.0.2&ElementSetName=summary&resultType=results&maxRecords=100

Get the metadata for the 15 dataset records starting from record 21

https://gateway.prod.wekeo2.eu/elastic-csw/service?service=CSW&request=GetRecords&version=2.0.2&ElementSetName=brief&resultType=results&maxRecords=15&startPosition=21

What's next?


Additional resources can be found in our Help Center. Should you require further assistance or wish to provide feedback, feel free to contact us through a chat session available in the bottom right corner of the page.

Did this answer your question?