The Library will provide access to a read-only API using an instance of Apache Solr that has indexed the content and/or metadata of the digital objects; API IDs and Keys that will make this API accessible to participants will be distributed at the hackathon kick-off on April 1, 2014. Use of the API implies agreement with its Terms of Service and Disclaimer, given below.

Detailed information on the API is available on the #HackFSM API Details page.

In addition to documentation provided on this site, teams may wish to review general information about Apache Solr APIs and/or the Apache Solr Reference Guide (available as a PDF).

If you have a question about the Library's API before the event, please contact the organizers.

You may wish to use other FSM related material when implementing your #HackFSM interface. Information about the Pop Up Archive API is included on this site, and mentors from the Pop Up Archive will participate in #HackFSM.


Terms of Service

The Bancroft Library has assigned a Creative Commons Attribution-Noncommercial-Share Alike 3.0 United States License (http://creativecommons.org/licenses/by-nc-sa/3.0/us/) to the metadata accessible via the FSM Digital Archive API and Solr Index. This license grants permission for non-commercial, attributed re-use of the metadata accessible via the FSM Digital Archive API and Solr Index.
Attribution should include the creator name (fsmCreator), if available in the metadata, and the name of the holding institution, as follows:
Credit: [Creator Name], Courtesy of The Bancroft Library.
Materials represented or linked in the data accessible via the API and Solr Index are made available for non-commercial use. Some materials represented or linked in the data accessible via the API and Solr Index may be protected by the U.S. Copyright Law (Title 17, U.S.C.) or subject to other rights, such as rights of privacy or the use of names and likenesses. Transmission or reproduction of materials protected by copyright beyond that allowed by fair use requires the written permission of the copyright owners. Works not in the public domain cannot be commercially exploited without permission of the copyright owner. Responsibility for any use rests exclusively with the user.
The Bancroft is eager to hear from any copyright owners who are not properly identified so that appropriate information may be provided in the future. The Bancroft will work in a timely manner to remove material from public view as it addresses any copyright concerns or other issues such as libel or invasion of privacy.
The Bancroft Library plans to host the FSM Digital Archive (Solr) API for a period of 18 month, ending November 1, 2015. The Bancroft Library makes no representations or warranties of any kind, express or implied, as to the API or Solr Index‘s operation or the information, content or materials included via the API or Solr Index; all of which are provided on an “as is” and “as available” basis. To the full extent permissible by applicable law, The Bancroft Library hereby disclaims all warranties, express or implied, including but not limited to implied warranties of merchantability and fitness for any particular purpose. The Bancroft Library will not be liable for any damages of any kind arising from your use of or inability to use the API or Solr Index. You expressly agree that you use the API and Solr Index, or any materials or content accessible via the API or Solr Index, solely at your own risk. You also hereby agree to indemnify UC Berkeley and The Bancroft Library, its employees, agents, and affiliates from any and all claims and/or damages (including but not limited to reasonable attorneys' fees) resulting from any claim brought by any third party relating to your use of the API or Solr Index, or any materials or content obtained from the API or Solr Index.


#HackFSM was a one-time event held in April 2014. The winning site is now available. A white paper on #HackFSM has also been published, with practical information for other libraries that are interested in holding hackathons.