---
title: TvEpisode
framework: Apple TV Feed
role: symbol
role_heading: Object
platforms: [appletvfeed 1.0+]
path: appletvfeed/tvepisode
---

# TvEpisode

The data structure that represents a TV episode resource.

## Declaration

```data
object TvEpisode
```

## Properties

artworks: (Required) A mapping of locale to localized artwork. castAndCrew: (Required) A list of cast and crew for the TV episode. description: (Required) A mapping of locale to localized descriptions of the TV episode. durationInMillis: The length of the episode in milliseconds. episodeNumber: The sequence number of the TV episode in the TV season it belongs to. externalContentIds: (Required) A list of unique identifiers for the TV episode in the catalog of another provider. genres: (Required) A list of genres associated with the TV episode. id: (Required) The unique identifier for the TV episode. lastModifiedTime: The time, in ISO 8601 format, of the entity’s most recent update. name: (Required) A mapping of locale to localized names for the TV episode. originalAirDate: The date when the episode first aired in YYYY-MM-DD format. prices: (Required) A mapping of storefront to pricing information and availability. rating: (Required) A list of ratings for the TV episode in different rating systems. seasonId: The unique identifier for the TV season that the episode belongs to. seasonNumber: The sequence number of the TV season. showId: The unique identifier for the TV show that the episode belongs to. url: (Required) A mapping of two-letter country code to URLs for the TV episode.

## Topics

### Related objects

- [TvEpisode.Artworks](appletvfeed/tvepisode/artworks-data.dictionary.md)
- [TvEpisode.CastAndCrew](appletvfeed/tvepisode/castandcrew-data.dictionary.md)
- [TvEpisode.Description](appletvfeed/tvepisode/description-data.dictionary.md)
- [TvEpisode.ExternalContentId](appletvfeed/tvepisode/externalcontentid.md)
- [TvEpisode.Genre](appletvfeed/tvepisode/genre.md)
- [TvEpisode.Name](appletvfeed/tvepisode/name-data.dictionary.md)
- [TvEpisode.Prices](appletvfeed/tvepisode/prices-data.dictionary.md)
- [TvEpisode.Rating](appletvfeed/tvepisode/rating-data.dictionary.md)
- [TvEpisode.Url](appletvfeed/tvepisode/url-data.dictionary.md)

## See Also

### Objects

- [Movie](appletvfeed/movie.md)
- [TvSeason](appletvfeed/tvseason.md)
- [TvShow](appletvfeed/tvshow.md)
- [SportingEvent](appletvfeed/sportingevent.md)