API:Update Records

From TvDBwiki

The Update Records contain all of the series, episode, and banner records that have been updated in a specific timeframe. They include the id of the series or episode that was updated or the pertinent banner information. There is also a time attribute on the root item that designates when the update file was created. This can be used to compared with the next update.

To reduce the load on the server, you should use the smallest one possible. For example, if you updated the client database a few hours ago, you should use the _day file instead of the _week, _month, or _all file. All Update Records are also provided in zip format. Please use these whenever possible to conserve bandwidth and client download time.

You'll notice that there are no episodes in the updates_all files. This is due to the size of the uncompressed file being over 500 MiB.

[edit] Files

Note: All file sizes given are from a single sample day. They may vary considerably, but will probably remain within 50% of the size listed. All times are accurate to the second (day = 86400 seconds, week = 604800 seconds, etc).

updates_day.xml
All updates within the last 24 hours
Uncompressed 161k

updates_day.zip
All updates within the last 24 hours
Compressed 20k

updates_week.xml
All updates within the last 7 days (One Week)
Uncompressed 600k

updates_week.zip
All updates within the last 7 days
Compressed 64k

updates_month.xml
All updates within the last 30 days (One Month)
Uncompressed 1 MiB

updates_month.zip
All updates within the last 30 days
Compressed 117k

updates_all.xml
All updates (excludes episodes)
Uncompressed 22 MiB

updates_all.zip
All updates (excludes episodes)
Compressed 1.7 MiB

[edit] Banner Fields

type

series or season

format

graphical, text, or blank for series banners standard or wide for season banners

Series

The id of the series that the banner relates to.

SeasonNum

The season number the banner relates to. Only appears for season banners.

language

The language abbreviation, since some banners are translated.

Avaliable Languages

path

Generate the actual banner URL with: <mirrorpath>/banners/<path>

[edit] Example Results

<?xml version="1.0" encoding="UTF-8" ?>
<Data time="1203923101">
  <Series>
    <id>71969</id>
    <time>1203848965</time>
  </Series>
  <Series>
    <id>73141</id>
    <time>1203882947</time>
  </Series>
  <Episode>
    <id>326268</id>
    <time>1203848662</time>
  </Episode>
  <Episode>
    <id>326267</id>
    <time>1203848597</time>
  </Episode>
  <Banner>
    <SeasonNum>1</SeasonNum>
    <Series>81325</Series>
    <format>graphical</format>
    <language>en</language>
    <path>graphical/81325-g3.jpg</path>
    <type>series</type>
  </Banner>
  <Banner>
    <SeasonNum>1</SeasonNum>
    <Series>79302</Series>
    <format>standard</format>
    <language>en</language>
    <path>seasons/79302-1.jpg</path>
    <type>season</type>
  </Banner>
</Data>