ISBNdb.com Home | Categories | Subjects | Authors | Publishers | Your Account (A)
ISBN or Keywords:
Account Home
Developer Area
 - Manage Keys
 - Keys Usage
 - API Docs
Change Password
Log out
Statistics (11/18/2008):
 • Books:3,934,321
 • Subjects:1,605,626
 • Authors:1,160,393
 • Publishers:  286,056
 • Sources:9,502,168
Contents | Previous | Next
API Description: Authors Collection Specifics

The 'authors' collection provides information about book authors. To retrieve corresponding books you can use 'person_id' to search in the books collection.

Note: There is currently no distinction about roles a person played in the creating of a book (author/editor/illustrator/etc). This may change in the future.

The base URL for the authors collection access is:

http://isbndb.com/api/authors.xml

Arguments

Authors collection supports the following indexes:
name
Performs a search on the author name. For example:
/api/authors.xml?access_key=Z&index1=name&value1=atkinson+anthony
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.

person_id
Retrieving author data by ISBNdb.com's person ID. Returns at most one match. Example:
/api/authors.xml?access_key=Z&index1=person_id&value1=anthony_a_atkinson

Results

By default, if no additional 'results' values specified, the book authors collection returns only a set of AuthorData/Name tag pairs. For example:
/api/authors.xml?access_key=Z&index1=name&value1=anthony+atkinson
<?xml version="1.0" encoding="UTF-8"?>
<ISBNdb server_time="2006-01-22T20:51:46">
 <AuthorList total_results="1" page_size="10" page_number="1" shown_results="1">
  <AuthorData person_id="anthony_a_atkinson">
   <Name>Anthony A. Atkinson</Name>
  </AuthorData>
 </AuthorList>
</ISBNdb>

In addition to common 'results' blocks the book authors collection adds some that are authors specific. The syntax remains the same -- comma separated values in the 'results' argument.

details
Shows more details about the author. For example:
/api/authors.xml?access_key=Z&results=details&index1=person_id&value1=anthony_a_atkinson
<?xml version="1.0" encoding="UTF-8"?>
<ISBNdb server_time="2006-01-22T20:56:03">
 <AuthorList total_results="1" page_size="10" page_number="1" shown_results="1">
  <AuthorData person_id="anthony_a_atkinson">
   <Name>Anthony A. Atkinson</Name>
   <Details first_name="Anthony" last_name="Atkinson" dates="" has_books="1" />
  </AuthorData>
 </AuthorList>
</ISBNdb>

categories
Shows a list of categories this author is listed in. Typically, this shows only one category where authors are listed alphabetically.
/api/authors.xml?access_key=Z&results=categories&index1=person_id&value1=anthony_a_atkinson
<?xml version="1.0" encoding="UTF-8"?>
<ISBNdb server_time="2006-01-22T21:00:16">
 <AuthorList total_results="1" page_size="10" page_number="1" shown_results="1">
  <AuthorData person_id="anthony_a_atkinson">
   <Name>Anthony A. Atkinson</Name>
   <Categories>
    <Category category_id="alphabetically.authors.a.n">N</Category>
   </Categories>
  </AuthorData>
 </AuthorList>
</ISBNdb>
subjects
Shows a list of subjects this author has books about. You can then search for books data using 'subject_id' as a key.
/api/authors.xml?access_key=Z&results=subjects&index1=person_id&value1=anthony_a_atkinson
<?xml version="1.0" encoding="UTF-8"?>
<ISBNdb server_time="2006-01-22T21:10:52">
 <AuthorList total_results="1" page_size="10" page_number="1" shown_results="1">
  <AuthorData person_id="anthony_a_atkinson">
   <Name>Anthony A. Atkinson</Name>
   <Subjects>
    <Subject subject_id="managerial_accounting" book_count="11">
     Managerial accounting
    </Subject>
    <Subject subject_id="income_tax_reform" book_count="2">
     Income tax, Reform
    </Subject>
   </Subjects>
  </AuthorData>
 </AuthorList>
</ISBNdb>
Contents | Previous | Next
Copyright © 2002-2008 ISBNdb.com FAQ | Privacy Policy | Contact ISBNdb.com