Authors
Main Authors
Filename: resolvedauthors.xml
Sample Feed: resolvedauthors_small.xml
Contents and Purpose
This is a feed of authors to the works for which they are the "main" author.
Note that, at present, author names are not provided.
Concepts
Primary author. A primary author is an author primarily responsible for a work. Most works have one. A work with co-authors has two.
Main author. The main author is the first "primary author" responsible for the work, or the first secondary author, if there is no primary author. If there are two primary authors, only one is considered the main author.
For other authors, both other primary authors and secondary authors, see the "Secondary Authors" feed (below).
Example
<authorresolved>
<author id="2">
<id>2</id>
<bsa>brenemandavidw</bsa>
<worklist>
<work>1136833</work>
<work>4811881</work>
<work>5469198</work>
<work>11187794</work>
<work>11455650</work>
</worklist>
</author>
</authorresolved>Elements and Attributes
<authorresolved> is the top-level
element.
<author>is repeated. "Author" is defined as a single person, with a body of works. Two authors with the same name are two authors. An author called by two names is only one author. Works can have no main author.id="N"(required) is the numerical id of the author, repeated in the<id>element, below.<id>(required) is the numerical id of the author, again.<bsa>(required) is an internal LibraryThing concept. To get the LibraryThing author page, replace "bsa" with the bsa here: https://www.librarything.com/author/bsa.<worklist>(required) encloses the author's<work>s.<work>(repeatable) is one of the works for which the author is the main author. The text inside the element contains the work id, or workcode.
Main Authors, Special
Filename: resolvedauthors_special.xml
Sample Feed: resolvedauthors_special_small.xml
Contents and Purpose
This is a feed of authors used in the authorimages XML feed. It is formatted in every way the same as resolvedauthors, but contains 50-75,000 authors, not several million.
Secondary Authors
Filename: resolvedauthors_secondary.xml
Sample Feed: resolvedauthors_secondary_small.xml
Contents and Purpose
This is a feed of authors to the works for which they are not the "main" author. See "concepts" above under "Main Authors" feed.
Note that, at present, author names are not provided.
Example
<authorresolvedsecondary>
<author id="1">
<id>1</id>
<bsa>craftkinukoy</bsa>
<worklist>
<work id="1506">
<id>1506</id>
<actionlist>
<action>
<role controlled="true">
<![CDATA[ Cover artist ]]>
</role>
<wholework>0</wholework>
<primary>0</primary>
</action>
</actionlist>
</work>
</worklist>
</author>
</authorresolvedsecondary>Elements and Attributes
<authorresolvedsecondary> is the
top-level element.
<author>is repeated. "Author" is defined as a single person, with a body of works. Two authors with the same name are two authors. An author called by two names is only one author.id="N"attr (required) is the numerical id of the author, repeated in the<id>element, below.<id>(required) is the numerical id of the author, again.<bsa>(required) is an internal LibraryThing concept. To get the LibraryThing author page, replace "bsa" with the bsa here: https://www.librarything.com/author/bsa.<worklist>(required) encloses the author's<work>s.<work>(repeatable) is one of the works for which the author is a secondary author.id="N"attr (required) is the numerical id of the work, also called the workcode, repeated in<id>.<id>(required) is the numerical id of the work, also called the workcode, again.<actionlist>is a list of the actions by which the author is associated with the work.<action>(repeatable) is one of the works for which the author is the main author.<role>(optional) is the name of the role the author had in production of the work, wrapped in aCDATAelement.controlled="true"attr (optional) is whether or not the text is on LibraryThing's default list, often massaged from different sources. Uncontrolled text is user-entered and may be quirky. If it is not controlled, this attribute is currently missing.
<wholework>is whether the author is associated with the whole work—all editions of the work—or not. For example, an audiobook narrator will not be associated with the entire work. Values are 0 (false) or 1 (true).<primary>is whether the author is a primary author of the work. Values are 0 (false) or 1 (true).
Author Images
Filename: authorimages.xml
Sample Feed: authorimages_small.xml
Contents and Purpose
This is a feed of works to the author photos and names that pertain to the photos.
Example
<authorphotos>
<author id="17">
<id>17</id>
<imageid>4357081</imageid>
<images>
<small>
http://pics.cdn.librarything.com//picsizes/65/69/6569fa4bc99dbf1654935536967427541473441_v5.jpg
</small>
<medium>
http://pics.cdn.librarything.com//picsizes/f0/15/f015a38546a7c546549355369674463414e7741_v5.jpg
</medium>
<large>
http://pics.cdn.librarything.com//picsizes/7c/95/7c955cfcb58f48e654935536967424b41556f42_v5.jpg
</large>
</images>
<names>
<name>Салман Рушди</name>
<name>サルマン ラシュディ</name>
<name>סלמאן רושדי</name>
<name>Salman Ruhdie</name>
<name>Salman Rusdie</name>
<name>by Salman Rushdie</name>
<name>S. RUSHDIE</name>
<name>Salaman Rushdie</name>
<name>Salman Rushdie</name>
<name>ind.-eng Salman Rushdie</name>
<name>Saman Rushdie</name>
<name>Salman</name>
</names>
</author>
</authorphotos>Elements and Attributes
<authorphotos> is the top-level element.
<author>(repeated) is an author.id="N"attr (required) is the numerical id of the author, repeated in the<id>element, below.<id>the unique id for each author.<imageid>a unique id for the image.<images>encloses<small>,<medium>and<large> image URLs.<names>a list of<name>elements. Works can be credited to different authors in different systems. The list is there to ensure that the author photo is only applied when the name is the same or similar to the one you're showing. These names are for confirmation only—not to be shown. They include "ratty data."Note If there are no names, you can use the image without worry.