Getting Started with Our Collections API
How do I use this guide?
This guide contains some definitions, context, examples, and technical documentation to get you started working with our collections data API. We encourage folks from all experience levels to explore, and you should feel free to skip to the sections that are useful for you.
What is an API?
An API (Application Programming Interface) is a set of instructions that tells one software application how to “talk to”, or transmit data, to another. If you have used DIMES, the Rockefeller Archive Center’s site to enable search and access to our collections, you have used an API. For example, when you initiate a search for something in DIMES, your browser makes a request to the API, which delivers the data as the search results.
With the API, you can bypass the website interface and instead send requests directly to get the data. With this direct access, you can explore the data in different ways and build things.
Who can use our API?
Anyone can use it! We have made it publicly available for people like you to freely access. There is no sign up or authentication required.
Our data is released under a Creative Commons Zero (CC0) public domain dedication. See our full licensing statement for specific license terms as well as best practices for repurposing this data.
What is the data and where does it come from?
Our archival holdings are arranged and described by Rockefeller Archive Center archivists to make them accessible and facilitate use by providing information about their content and context. Archivists create descriptive information about:
- Archival records.
- Agents, who are records creators and other people, organizations, and families related to the records.
- Relevant biographical, historical, or administrative activities.
- The relationships between these records, agents, and activities.
All of this information is managed in its own system and made available via the API. The API also includes data used specifically in the DIMES website to improve search and discovery on the site.
Learn more about what data is available by browsing the available API endpoints, or points of entry to communicate with the API.
What can I do with the API?
You can use the API to get our collections data, and you can use that data in any way you like: build applications, visualize and analyze data in new ways, search and browse, and generally make connections.
Example project: Read our blog post about an experiment to explore Rockefeller Archive Center collections through various visualizations.
Where can I report an issue?
Please let us know if something isn’t working as expected! You can either file an issue in the GitHub repository, or email us at firstname.lastname@example.org.
Create something? Share with us!
Keep in touch. We’d love to hear about how you’re using our data. Find us on Twitter or email email@example.com.
Bulk data download
You can also access exports of our public collections data on GitHub. The data is generally exported on a bi-monthly basis.