XML Syndication
You can easily access our content via XML syndication using the following URI:http://xml.otvdb.com/request
Show Details
You can access the details of a show using:http://xml.otvdb.com/request?requesttype=showdetails
Parameters...
| Parameter | Description | Possible Values |
|---|---|---|
| id | The ID number of the show you want the details of | Integer |
| fullname | The full title of the show. | String such as The Simpsons or Futurama |
| slug | URL friendly slug of the show. | String such as the-simpsons or dawsons-creek |
| titletype | Sets whether titles are displayed as they actually appear or alphabetically, e.g. The Simpsons or Simpsons, The | standard, alphabetical |
Example query:
http://xml.otvdb.com/request?requesttype=showdetails&id=2&titletype=standard
This will request the details for The Simpsons using standard title formatting.
Return values...
| Node Name | Description | Value |
|---|---|---|
| title | The title of the show. | String |
| slug | The URL friendly slug of the show. | String |
| lastupdate | Date the entry was last updated. | RFC 2822 formatted date |
| description | Description of the show. | Text (possibly including HTML code) |
List Shows
You can list the shows in the database by using:http://xml.otvdb.com/request?requesttype=listshows
Up to 25 results will be returned at each time. You access more using the page parameter.
Parameters...
| Parameter | Description | Possible Values |
|---|---|---|
| letter | If you want to specific a letter or number the show must begin with you can do that here. | Char |
| orderby | Sets what ordering is used for the results - either via the most recently updated or alphabetically. | alphabetical, recency |
| titletype | Sets whether titles are displayed as they actually appear or alphabetically, e.g. The Simpsons or Simpsons, The | standard, alphabetical |
| results | Maximum number of results to be returned | 1-25 |
| page | If there are more than 25 results you can access more by specifying a results page number. | Integer |
Example query:
http://xml.otvdb.com/request?requesttype=listshows&letter=a&orderby=recency&titletype=standard
This will request shows beginning with A and order them most recently updated first using standard title formatting.
Return values...
| Node Name | Description | Value |
|---|---|---|
| title | The title of the show. | String |
| slug | The URL friendly slug of the show. | String |
| lastupdate | Date the entry was last updated. | RFC 2822 formatted date |
