Search in Collection

A list of all available OpenADB collections can be found on the OpenADB Website.

Code-Example:

# Import package
import openadbapi
import shapely # optinal, only for aoi needed

# Initialize class
openadb_api = openadbapi.API()

# Apply criteria to search in collection

args = {}
# args['revision'] = '00'
# args['start_cycle'] = '030'
# args['end_cycle'] = '030'
# args['start_date'] = '2021-05-16 20:37:36'
# args['end_date'] = '2021-08-16 20:37:36'

# limit to AOI
args['aoi'] = shapely.geometry.Polygon([[-14.4466,45.8609],[-14.4466,50.0091],[-6.6463,50.0091],[-6.6463,45.8609],[-14.4466,45.8609]])

collection = 'CRYOSAT2_L3_MIX_EOT_INT_1HZ_OC_NTC_V20'

# Search records in collection
results = openadb_api.search(collection, args)

Search Arguments:

‘start_cycle’ and ‘end_cycle’

The cycle number of the start and end cycle is a 3-digit number (e.g. 001 or 132).

‘start_date’ and ‘end_date’

The date format of the start and end date ‘YYYY-MM-DD HH:MM:SS’ (e.g. ‘2025-11-12 06:00:52’).

‘revision’

The number of revision is a 2-digit number (e.g. 00 or 01).

‘aoi’

Area of interest as Polygon using shapely.

Returned JSON response:

[
    {
        'collection': 'CRYOSAT2_L3_MIX_EOT_INT_1HZ_OC_NTC_V20',
        'cycle': '013',
        'pass_nr': '0160',
        'start_date': '2021-05-16 21:11:00',
        'end_date': '2021-05-16 21:55:04',
        'creation_date': '2023-01-27 07:57:58',
        'revision': '00',
        'num_obs': 2177,
        'filename': 'CRYOSAT2_L3_MIX_EOT_INT_1HZ_C013_P0160_20210516T211100Z_20210516T215504Z_20230127T075758Z_N02177_OC_NTC_V20_R00.nc',
    },
    {
        'collection': 'CRYOSAT2_L3_MIX_EOT_INT_1HZ_OC_NTC_V20',
        'cycle': '013',
        'pass_nr': '0161',
        'start_date': '2021-05-16 21:55:05'
        'end_date': '2021-05-16 22:38:38',
        'creation_date': '2023-01-27 07:57:58',
        'revision': '00',
        'num_obs': 2581,
        'filename': 'CRYOSAT2_L3_MIX_EOT_INT_1HZ_C013_P0161_20210516T215505Z_20210516T223838Z_20230127T075758Z_N02581_OC_NTC_V20_R00.nc',
    },
    ...
]