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 |