All Collections
WEkEO Data Viewer and Catalogue
Data Access
How to consume the Catalogue Service for the Web (CSW) API on WEkEO?
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 a week 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.

📌 Note: to get more information about CSW, we invite you to check the standard OGC documentation.

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

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

Here is the list of operations you can use via the CSW API on WEkEO:

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://pn-csw.prod.wekeo2.eu/elastic-csw/service?service=CSW&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 collection or dataset metadata (including IDs)

https://pn-csw.prod.wekeo2.eu/elastic-csw/service?service=CSW&request=GetRecords&version=2.0.2&ElementSetName=brief&resultType=results&maxRecords=100
Get WEkEO metadata via CSW API.

Get the detailed metadata of first 100 collection or dataset metadata (including IDs)

https://pn-csw.prod.wekeo2.eu/elastic-csw/service?service=CSW&request=GetRecords&version=2.0.2&ElementSetName=summary&resultType=results&maxRecords=100
Get WEkEO detailed metadata via CSW API.

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

https://pn-csw.prod.wekeo2.eu/elastic-csw/service?service=CSW&request=GetRecords&version=2.0.2&ElementSetName=brief&resultType=results&maxRecords=15&startPosition=21
Choose specific datasets to get WEkEO metadata.

What's next?

These articles might of interest for you:

We are user-driven and we implement users' suggestions, so feel free to contact us:

  • through a chat session available in the bottom right corner of the page

  • via our contact webpage

  • via e-mail to our support team (supportATwekeo.eu)

Related Articles
How to use the WEkEO Harmonized Data Access API REST with cURL?
How to use the WEkEO Harmonized Data Access API REST with Wget?
Did this answer your question?