Digital Collections Audio/Video
University of Maryland Libraries’ Digital Collections Audio/Video Content
OpenSearch
API Description: OpenSearch
OpenSearch Description: https://av.lib.umd.edu/catalog/opensearch.xml
JSON Endpoint: https://av.lib.umd.edu/catalog.json
Example:
#!/bin/bash
PARAMS='search_field=all_fields&q=athletics'
curl "https://av.lib.umd.edu/catalog?$PARAMS"
curl "https://av.lib.umd.edu/catalog.rss?$PARAMS"Example: digital-collections-av-search.py
digital-collections-av-search.py
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = []
# ///
import urllib.request
import json
import socket
import ssl
import sys
from urllib.error import HTTPError, URLError
# Search Digital Collections Audio/Video using JSON OpenSearch
BASE = 'https://av.lib.umd.edu/'
ENDPOINT = 'https://av.lib.umd.edu/catalog.json'
# A host name that does not resolve, or a certificate that will not verify,
# is a settled fact about the URL rather than a passing condition: it means
# this example is pointed somewhere that no longer answers for it. Every other
# connection failure -- refused, reset, timed out -- may succeed on a retry.
PERMANENT_FAILURES = (socket.gaierror, ssl.SSLCertVerificationError)
# Keyword query on 'Maryland'
params = {
"search_field": "all_fields",
"q": "maryland",
}
search_url = ENDPOINT + '?' + urllib.parse.urlencode(params)
# Get search results as parsed JSON
try:
with urllib.request.urlopen(search_url) as request:
response = json.loads(request.read())
except HTTPError as error:
print(f'{ENDPOINT} returned HTTP {error.code}: {error.reason}', file=sys.stderr)
# 75 = EX_TEMPFAIL: the service is reachable but cannot serve right now.
# A 4xx means this request is no longer valid, which is this example's problem.
sys.exit(75 if error.code >= 500 or error.code == 429 else 1)
except URLError as error:
# Nothing answered, so the request was never judged. What stopped it
# decides whose problem it is.
print(f'Could not reach {ENDPOINT}: {error.reason}', file=sys.stderr)
sys.exit(1 if isinstance(error.reason, PERMANENT_FAILURES) else 75)
except json.JSONDecodeError:
print(f'{ENDPOINT} did not return JSON', file=sys.stderr)
# A body that is not JSON means the API changed under this example.
sys.exit(1)
# Iterate over the returned items
for item in response['data']:
link = item['links']['self']
title = item['attributes']['title_tesi']['attributes']['value']
print('----')
print(f'Title: {title}')
print(f'Link: {link}')
Run this example with uv — no download or setup required:
uv run https://opendata.lib.umd.edu/code/digital-collections-av-search.pyOAI-PMH
API Description: OAI-PMH
Endpoint: https://api.av.lib.umd.edu/oai/api
Example:
#!/bin/bash
curl "https://api.av.lib.umd.edu/oai/api?verb=Identify"
curl "https://api.av.lib.umd.edu/oai/api?verb=ListSets"
curl "https://api.av.lib.umd.edu/oai/api?verb=ListMetadataFormats"Additional Examples:
- digital-collections-av-oaipmh.py Use OAI-PMH to harvest metadata in Digital Collections Audio/Video.
