HackTheHearst API

The Hearst Museum will provide access to a read-only API using an instance of Apache Solr that has indexed the metadata for the cataloged objects in the Hearst Museum’s collections. API IDs and keys that will make this API accessible to participants will be distributed at the hackathon kick-off on September 10, 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 HackTheHearst 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 Hearst Museum’s API before the event, please contact the organizers.

You may wish to use other cultural-heritage-related material or resources when implementing your HackTheHearst interface.

Terms of service

The Hearst Museum 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 Hearst Museum digital collections information API and Solr Index. This license grants permission for non-commercial, attributed re-use of the metadata accessible via the Hearst Museum digital collections information API and Solr Index.

Attribution should be as follows:

Credit: Courtesy of The Phoebe A. Hearst Museum of Anthropology.

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 Phoebe A. Hearst Museum of Anthropology is eager to hear from any copyright owners who are not properly identified so that appropriate information may be provided in the future. The Phoebe A. Hearst Museum of Anthropology 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.

Disclaimer

The Phoebe A. Hearst Museum of Anthropology plans to host the Hearst Museum digital collections information (Solr) API for a period of at least 18 months, ending no sooner than March 10, 2016. The Phoebe A. Hearst Museum of Anthropology 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 Phoebe A. Hearst Museum of Anthropology hereby disclaims all warranties, express or implied, including but not limited to implied warranties of merchantability and fitness for any particular purpose. The Phoebe A. Hearst Museum of Anthropology 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 Phoebe A. Hearst Museum of Anthropology, 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.