Access Point for the National Archives' Collection Database
The National Archives and Records Administration (NARA) offers a Catalog API, providing machine-readable access to its vast collection of public data. This article outlines the guidelines for using the API and offers advice on locating the terms and conditions for its use.
Using the API
To access and use the API, users must request an API key and incorporate it into each API request. The API allows retrieval of metadata in JSON format for any given record or search results set, and it supports various search options, such as keyword searches, range searches, sorting, and specifying particular fields to return.
Terms and Conditions
While the search results do not contain explicit terms and conditions for the National Archives Catalog API, users are expected to comply with federal open data policies, adhering to usage limitations, attribution, and non-commercial or appropriate use clauses as defined by NARA.
To find the concrete terms and conditions for the National Archives Catalog API, users are advised to:
- Visit the official NARA website or their developer/API section.
- Look for a terms of service, API usage policy, or data license document related to their catalog API.
- Contact NARA directly or check their legal or policy disclosures about digital services.
API Usage Guidelines
Users are not allowed to use the API for illegal or defamatory purposes, violate the Citizen Contribution Policy, attack the API or the Catalog, gain unauthorized access, or manipulate data. Users must also agree to indemnify and hold harmless NARA from any claims arising from their use of the API.
The default API key is read-only, but users can request a read/write API key by emailing [email protected] with their email address and Catalog user name. Users are not allowed to scrape data or download all data from the Catalog via the API, as this may affect Catalog performance.
API Limitations
The API is subject to a rate limit of 10,000 queries per month per API key, with higher limits available upon request. NARA reserves the right to block access if a user attempts to exceed or circumvent these limits. In addition, API keys that have not been used during the past 12 months will be deactivated.
Attribution and Responsibility
All services which utilize or access the API should display a notice prominently within the application, as specified in the Attribution section. Users hereby warrant that their use of the API will not infringe or misappropriate the intellectual property rights of any third party. In no event will NARA be liable for any special, incidental, or consequential damages, the cost of procurement of substitute products or services, or for interruption of use or loss or corruption of data.
Conclusion
The National Archives Catalog API offers a wealth of opportunities for researchers, developers, and innovators to access and utilise the National Archives' extensive collection of public data. By adhering to the guidelines and terms and conditions, users can contribute to the facilitation of research and the spurring of innovation while respecting the intellectual property rights of the National Archives and its users.
