Skip to main content

An unoffical API for the New York Public Library

Project description

NYPL API
=========
An unofficial API for the New York Public Library Catalog

Dependencies
-----------

- requests (pip install requests)
- BeautifulSoup4 (pip install beautifulsoup4)

Installation
--------------

pip install NYPL_API


Use
----
>>> from NYPL import search
>>> search(title="The View from Saturday", author="E.L. Konigsburg")

Sample
---
see example.py (https://github.com/susinmotion/NYPL/blob/master/example.py)

Output
---
Results are output as a list of Book objects, which have the following attributes:
- author
- title (in the format "title (genre)" )
- link_to_copies (url to a page of the libraries that have the book)
- copies (a list of all copies of the book)*
- available_copies (a list of *available* copies of the book)*

copies and available_copies are represented as lists of Copy objects, which have the following attributes:
- location (eg. "96th Street")
- collection (eg. "96th Street Children's Fiction")
- callNo (call number, eg. "J FIC K"
- status (eg. "DUE 10-28-14")

* copies and available copies are not generated automatically with default search. They can be generated automatically with robust search:

search(keyword, title, author, lazy=False)


More Info
--------

Unfortunately, the official New York Public Library is only available to library employees, and during library hack-a-thons. Now, it's data anytime--Happy developing!

Feedback is most welcome.
https://github.com/susinmotion/NYPL_API

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
NYPL-0.1.12.tar.gz (3.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page