API:Update Records

From TvDBwiki
Jump to: navigation, search

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.


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

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>

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>
Personal tools