How do I use Library APIs (like LibraryCloud)?

Library APIs (application programming interfaces) let you access structured information about library collections. To use an API, you construct a URL that sends a request. You can use your browser, a special app, or a programming language to send requests. 


LibraryCloud is the best API to start with, because it’s a centralized store of metadata from across Harvard’s various cataloging systems. To get started with LibraryCloud, open up a new browser tab and build the URL.


  1. Start with the base: https://api.lib.harvard.edu/v2/items
  2. Add a question mark to start the query section: ?
  3. Add the desired parameters. Use an equals sign to pair the name of the field with the term. Separate parameters with an ampersand: q=charles river&originPlace=boston
  4. Paste the full URL you created in your browser and go: https://api.lib.harvard.edu/v2/items?q=charles river&originPlace=boston


Learn more about Harvard Library APIs, or look up LibraryCloud field names and other details.

Service Alert:
  • Ask a Librarian services, including chat and email, will be suspended from December 21, 2024 through January 1, 2025. Queries received during this time will be answered as soon as possible following our return on January 2.
  • If you're experiencing an ongoing technical issue when you attempt to access library materials with your HarvardKey during these times, please report it to Library Technology Services.

Chat

 

Monday-Thursday 9am-9pm

Friday-Saturday 9am-5pm

Sunday 12noon-7pm

Chat is intended for brief inquiries from the Harvard community.

Meet

Talk to a librarian for advice on defining your topic, developing your research strategy, and locating and using sources. Make an appointment now.

These services are intended primarily for Harvard University faculty, staff and students. If you are not affiliated with Harvard, please use these services only to request information about the Library and its collections.