CRDL API

This site provides an API for researchers and digital humanists. Responses come in either XML or JSON flavor.

Endpoints

URL Scheme Description Expected Response Notes Example
https://crdl.usg.edu/records.json
https://crdl.usg.edu/records.xml
Returns all records in a paginated list with facet data. Item(s), Facet information Combine with query parameters to limit results. Results are paginated. JSON results for query "columns" in Clarke County
https://crdl.usg.edu/record/{identifier}.json
https://crdl.usg.edu/record/{identifier}.xml
Returns all available metadata for the record corresponding to identifier. An Item JSON for nge_ngen_m-3543
https://crdl.usg.edu/records.json?search_field=record_id&q={identifier}+OR+{another_identifier} Returns JSON for a specific set of records using record IDs separated by OR. Item(s), Facet information Identifiers can be extracted from individual record page URLs (in this example the ID is gsu_lane_13327) JSON for dlg_efhf_efhf and dlg_efhf_efhf2
https://crdl.usg.edu/collections.json
https://crdl.usg.edu/collections.xml
Returns all collection records in a paginated list with facet data. Collection(s), Facet information Combine with query parameters to limit results. Results are paginated. JSON results for collections matching query "architecture"
https://crdl.usg.edu/collection/{identifier}.json
https://crdl.usg.edu/collection/{identifier}.xml
Returns all items contained in the collection corresponding to Item(s), Facet information JSON for all records in collection dlg_bald
https://crdl.usg.edu/people/{letter}.json
Returns all people whose last name begin with letter. People, Facet information JSON results for people with a last name starting with the letter b
https://crdl.usg.edu/people/{identifier}.json
Returns all available metadata for the person corresponding to identifier. Person, related Records, Facet information JSON for person king_martin_luther_jr_1929_1968
https://crdl.usg.edu/events.json
Returns all events. Event(s), Facet information JSON results for all events
https://crdl.usg.edu/events/{identifier}.json
Returns all available metadata for the Event corresponding to identifier. Event, related Records, Facet information JSON for event montgomery_bus_boycott