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."