OAI-PMH Guide (GLAM)

Protocol for exposing repository metadata (Data Provider) for the GLAM digital collection.

BaseURL: https://thamkhwannak.meeomni.com/oai/

Overview

OAI-PMH (Open Archives Initiative Protocol for Metadata Harvesting) is a standard for exposing metadata over HTTP in XML, enabling harvesters to aggregate and build cross-repository search.

Data Provider: your GLAM system exposing this BaseURL.
Service Provider: harvesters such as OAIster, BASE, OpenAIRE.
Format: supports oai_dc (Dublin Core) and the custom oai_glam schema.

Core Commands (Verbs)

Identify

Repository-level information.

https://thamkhwannak.meeomni.com/oai/?verb=Identify

ListMetadataFormats

Available metadata formats (oai_dc, oai_glam).

https://thamkhwannak.meeomni.com/oai/?verb=ListMetadataFormats

ListSets

Available sets (e.g., country:*, type:*).

https://thamkhwannak.meeomni.com/oai/?verb=ListSets

ListIdentifiers

Headers only (lighter). You can send either prefix.

https://thamkhwannak.meeomni.com/oai/?verb=ListIdentifiers&metadataPrefix=oai_dc

https://thamkhwannak.meeomni.com/oai/?verb=ListIdentifiers&metadataPrefix=oai_glam

ListRecords

Full records in the requested format.

https://thamkhwannak.meeomni.com/oai/?verb=ListRecords&metadataPrefix=oai_dc

https://thamkhwannak.meeomni.com/oai/?verb=ListRecords&metadataPrefix=oai_glam

GetRecord

Single record by identifier.

https://thamkhwannak.meeomni.com/oai/?verb=GetRecord&metadataPrefix=oai_dc&identifier=oai:glam.asiana.net:core/2

https://thamkhwannak.meeomni.com/oai/?verb=GetRecord&metadataPrefix=oai_glam&identifier=oai:glam.asiana.net:core/2

Parameters

metadataPrefix – use oai_dc or oai_glam.
from, until – date filters (YYYY-MM-DD or YYYY-MM-DDThh:mm:ssZ).
set – filter by set, e.g., country:philippines, type:painting.
resumptionToken – pagination token; when provided, other params are usually ignored.

https://thamkhwannak.meeomni.com/oai/?verb=ListRecords&metadataPrefix=oai_glam&set=type:painting&from=2025-01-01T00:00:00Z&until=2025-12-31T23:59:59Z

Troubleshooting

“Extra content at the end...” – extra output mixed into XML; disable display_errors, clear buffers, echo one XML and exit;
500 – check PHP extensions (xml, xmlwriter), file permissions, and require_once paths.
Empty ListRecords – you may be on a later page (token too large) or filters returned zero results.

Live Tests

Identify ListMetadataFormats ListSets ListIdentifiers (oai_dc) ListRecords (oai_dc) ListIdentifiers (oai_glam) ListRecords (oai_glam) GetRecord (oai_glam)

* Opens result in a new tab

Live Sets

Failed to connect to ListSets.

No sets found (or fetch failed).