API
Make something great with our API.
Make something great with our API.
The RRN API exposes the data contained within the RRN in a structured way for use by developers. Please feel free to email [email protected] if you have any feedback about the API. We'd love to know how you're using the RRN API, send us an email and let us know!
A page of items can be retrieved in an XML or JSON representation by appending .xml or .json to the end of the path.
https://www.rrncommunity.org/items.xml
or https://www.rrncommunity.org/items.json
Any search that can be done using the faceted search tools can also be represented as XML (or JSON) using the same approach.
https://www.rrncommunity.org/items.xml?filters=type mask, culture Haida
NOTE: Route-globbed search urls are no longer supported. Please update your links accordingly.
/items/type-mask/culture-Haida
becomes /items?filters=type mask, culture Haida
https://www.rrncommunity.org/items.json?page=2
https://www.rrncommunity.org/items.json?per_page=25
XML and JSON representations of a single item can be returned in a similar manner.
https://www.rrncommunity.org/items/1.xml
or https://www.rrncommunity.org/items/1.json
Returns a JSON array of autocompleted search queries. The API will try to autocomplete the last tag provided. Results are returned sorted by number of results.
https://www.rrncommunity.org/filters/autocomplete_tags.json?filters=m
The results can be limited to a single facet by adding that facet param to the query.
https://www.rrncommunity.org/filters/autocomplete_tags.json?filters=type m
Results are also limited based on the complete search clauses in the query string.
https://www.rrncommunity.org/filters/autocomplete_tags.json?filters=culture Haida, type m
Returns a JSON array of tags for a particular facet. Results are returned in alphabetical order.
https://www.rrncommunity.org/filters.json?filter_type=item_types
The tags can be limited by providing a search query.
https://www.rrncommunity.org/filters.json?filter_type=materials&filters=type mask
data-filter-type
HTML attribute of that tag cloud on the RRN.
You may use these images if you would like to link back to the RRN.
The following is a list of projects which make use of the RRN's API. Please email us at [email protected] if you would like to add your site to the list.
This project is focused on a little-known collection of objects housed at the Smithsonian Institution in Washington, DC. Called the MacFarlane Collection after the Hudson’s Bay trader who assembled the objects, the collection includes nearly 5000 natural history specimens, such as birds’ eggs and animal skeletons, and an additional 300 cultural objects collected from Anderson River Inuvialuit in the 1860s.