API:actors.xml
From TvDBwiki
The actors.xml file holds all of the actor information for a series.
[edit] Explanation of Fields
id
A unique id per actor. At some point actors will be globally unique but for now they're just unique per series.
Name
The actual name of the actor.
Role
The name of the actor's character in the series. This may include multiple roles in comma-separated format.
Image
The path to an image for the actor in this role. Should be appended to <mirrorpath>/banners/ to get the entire URL.
SortOrder
This matches the First, Second, Third, and Don't Care options on the site, which determine if the actor is shown on the series page or not. First (SortOrder=0), Second (SortOrder=1), and Third (SortOrder=2) generally mean the actor plays a primary role in the series. Don't Care (SortOrder=3) generally means the actor plays a lesser role. In some series there are no primary actors, so all actors will have a SortOrder of 3. The actors are also listed in the report in SortOrder, followed by those with images, and then finally by Name. So using the order they show up in the file is a valid method.
[edit] Example Results
<?xml version="1.0" encoding="UTF-8" ?>
<Actors>
<Actor>
<id>22017</id>
<Image>actors/22017.jpg</Image>
<Name>Zachary Levi</Name>
<Role>Chuck Bartowski</Role>
<SortOrder>0</SortOrder>
</Actor>
<Actor>
<id>22019</id>
<Image>actors/22019.jpg</Image>
<Name>Yvonne Strzechowski</Name>
<Role>Sarah Walker</Role>
<SortOrder>1</SortOrder>
</Actor>
<Actor>
<id>22018</id>
<Image>actors/22018.jpg</Image>
<Name>Adam Baldwin</Name>
<Role>Major John Casey</Role>
<SortOrder>2</SortOrder>
</Actor>
<Actor>
<id>77810</id>
<Image>actors/77810.jpg</Image>
<Name>Sarah Lancaster</Name>
<Role>Ellie Bartowski</Role>
<SortOrder>3</SortOrder>
</Actor>
<Actor>
<id>77809</id>
<Image>actors/77809.jpg</Image>
<Name>Joshua Gomez</Name>
<Role>Morgan Pace</Role>
<SortOrder>3</SortOrder>
</Actor>
</Actors>
