|
API Description: Publishers Collection Specifics
The 'publishers' collection provides information about book publishers. To
retrieve corresponding books you can use 'publisher_id' to search in the books collection.
The base URL for the publishers collection access is:
http://isbndb.com/api/publishers.xml
Arguments
Publishers collection supports the following indexes:
- name
- Performs a search on the publisher name. For example:
/api/publishers.xml?access_key=Z&index1=name&value1=nation+books
The search follows the same rules and syntax as the
search on the website itself -- you can group words together using
double quotes, all non-ignored words must be present in the results.
- publisher_id
- Retrieving publisher data by ISBNdb.com's publisher ID. Returns at most
one match. Example:
/api/publishers.xml?access_key=Z&index1=publisher_id&value1=kaplan
Results
By default, if no additional 'results' values specified, the book
publishers collection returns only a set of PublisherData/Name tag
pairs. For example:
/api/publishers.xml?access_key=Z&index1=name&value1=kaplan
<?xml version="1.0" encoding="UTF-8"?>
<ISBNdb server_time="2006-01-18T12:55:01">
<PublisherList total_results="2" page_size="10" page_number="1" shown_results="2">
<PublisherData publisher_id="dearborn_trade_a_kaplan_profes">
<Name>Dearborn Trade, a Kaplan Professional Company</Name>
</PublisherData>
<PublisherData publisher_id="kaplan">
<Name>Kaplan</Name>
</PublisherData>
</PublisherList>
</ISBNdb>
In addition to common 'results' blocks the
book publishers collection adds some that are publishers specific. The
syntax remains the same -- comma separated values in the 'results'
argument.
- details
- Shows some details about publisher. For example:
/api/publishers.xml?access_key=Z&results=details&index1=publisher_id&value1=oreilly
<?xml version="1.0" encoding="UTF-8"?>
<ISBNdb server_time="2006-01-18T13:28:10">
<PublisherList total_results="1" page_size="10" page_number="1" shown_results="1">
<PublisherData publisher_id="oreilly">
<Name>O'Reilly</Name>
<Details location="Sebastopol, CA"/>
</PublisherData>
</PublisherList>
</ISBNdb>
- categories
- Shows a list of categories this publisher is listed in. Typically,
this shows only one category where publishers are listed
alphabetically.
/api/publishers.xml?access_key=Z&results=categories&index1=publisher_id&value1=oreilly
<?xml version="1.0" encoding="UTF-8"?>
<ISBNdb server_time="2006-01-18T13:28:10">
<PublisherList total_results="1" page_size="10" page_number="1" shown_results="1">
<PublisherData publisher_id="oreilly">
<Name>O'Reilly</Name>
<Categories>
<Category category_id="alphabetically.publishers.o.r">Publishers, 'OR'</Category>
</Categories>
</PublisherData>
</PublisherList>
</ISBNdb>
|
