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 a CDATA
element.
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 authors 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.
Author Images by Work
Filename: authorimagesbywork.xml
Sample Feed: authorimagesbywork_small.xml
Contents and Purpose
This is a feed of works to the primary author photos and names that pertain to the photos. It inverts the relationship of the authorimages feed—instead of organizing by author, it organizes by work.
Only works with primary authors who have images are included.
Example
<authorimagesbywork>
<work workcode="3600">
<workcode>3600</workcode>
<imageid>9165951</imageid>
<author_id>342</author_id>
<images>
<small>
https://pics.cdn.librarything.com//picsizes/13/95/13955553-x-h110-w110-pv25_654f48783141427541473441_v5.jpg
</small>
<medium>
https://pics.cdn.librarything.com//picsizes/13/95/13955553-x-h220-w220-pv25_654f487831414463414e7741_v5.jpg
</medium>
<large>
https://pics.cdn.librarything.com//picsizes/13/95/13955553-x-h330-w330-pv25_654f48783141424b41556f42_v5.jpg
</large>
</images>
<names>
<name>Карл Маркс</name>
<name>Karl Marx</name>
<name>マルクス</name>
<name>カール マルクス</name>
<name>Carlos Marx</name>
</names>
</work>
</authorimagesbywork>
Elements and Attributes
<authorimagesbywork>
is the top-level
element.
<work>
is repeated.
Each work entry shows the primary author's image for that work.
workcode="N"
attr (required) is the numerical id of the work, repeated in the<workcode>
element, below.
<workcode>
(required) is the numerical id of
the work, again.
<imageid>
(required) is a unique id for the image.
<author_id>
(required) is the numerical id of
the primary author whose image is shown.
<images>
(required) encloses <small>
,
<medium>
and <large>
image URLs.
<names>
(required) is 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."