tmdb

package

Go to main page

Versions in this module

v0

v0.3.3

Nov 4, 2026

Changes in this version

type Client

+ func (c *Client) UserList(ctx context.Context, id int64, page int) (UserListPage, error)

+ type UserListItem struct

+ ID int64

+ MediaType string

+ type UserListPage struct

+ Items []UserListItem

+ Page int

+ Results []UserListItem

+ TotalPages int

+ TotalResults int

+ func GetUserListPage(ctx context.Context, client interface{ ... }, id int64, page int) (UserListPage, error)

v0.3.2

Nov 3, 2026

v0.3.1

Nov 1, 2026

v0.3.0

Nov 1, 2026

Changes in this version

+ var ErrUnavailable = errors.New("tmdb: temporarily unreachable")

+ type AltTitle struct

+ Country string

+ Title string

+ Type string

+ type AltTitles struct

+ Results []AltTitle

+ Titles []AltTitle

type Client

+ func (c *Client) CachedArtworkVariants(t *core.Title, language string) (*Images, bool)

+ func (c *Client) MovieReleaseDates(ctx context.Context, id int64) (*ReleaseDates, error)

+ func (c *Client) TVContentRatings(ctx context.Context, id int64) (*ContentRatings, error)

type MovieDetails

+ AlternativeTitles *AltTitles

type TVDetails

+ AlternativeTitles *AltTitles

v0.2.58

Oct 31, 2026

v0.2.57

Oct 31, 2026

v0.2.56

Oct 31, 2026

v0.2.55

Oct 31, 2026

v0.2.54

Oct 31, 2026

v0.2.53

Oct 31, 2026

v0.2.52

Oct 31, 2026

v0.2.51

Oct 31, 2026

v0.2.50

Oct 31, 2026

v0.2.49

Oct 30, 2026

v0.2.48

Oct 30, 2026

v0.2.47

Oct 30, 2026

v0.2.46

Oct 29, 2026

v0.2.45

Oct 29, 2026

v0.2.44

Oct 29, 2026

v0.2.43

Oct 29, 2026

v0.2.42

Oct 29, 2026

v0.2.41

Oct 29, 2026

v0.2.40

Oct 29, 2026

v0.2.39

Oct 29, 2026

v0.2.38

Oct 29, 2026

v0.2.37

Oct 29, 2026

Changes in this version

type Client

+ func (c *Client) MovieDetailsFresh(ctx context.Context, id int64) (*MovieDetails, error)

+ func (c *Client) TVDetailsFresh(ctx context.Context, id int64) (*TVDetails, error)

v0.2.36

Oct 29, 2026

v0.2.35

Oct 29, 2026

Changes in this version

type TVDetails

+ LastEpisodeToAir *Episode

v0.2.34

Oct 29, 2026

v0.2.33

Oct 29, 2026

v0.2.32

Oct 29, 2026

v0.2.31

Oct 28, 2026

v0.2.30

Oct 28, 2026

v0.2.29

Oct 28, 2026

v0.2.28

Oct 28, 2026

v0.2.27

Oct 28, 2026

v0.2.26

Oct 28, 2026

v0.2.25

Oct 28, 2026

v0.2.24

Oct 28, 2026

v0.2.23

Oct 28, 2026

v0.2.22

Oct 28, 2026

v0.2.21

Oct 28, 2026

v0.2.20

Oct 28, 2026

v0.2.19

Oct 28, 2026

v0.2.18

Oct 27, 2026

v0.2.17

Oct 27, 2026

v0.2.16

Oct 27, 2026

v0.2.15

Oct 27, 2026

v0.2.14

Oct 27, 2026

v0.2.13

Oct 26, 2026

v0.2.12

Oct 26, 2026

v0.2.11

Oct 26, 2026

v0.2.10

Oct 26, 2026

v0.2.9

Oct 25, 2026

v0.2.8

Oct 22, 2026

v0.2.7

Oct 22, 2026

Changes in this version

type Client

+ func (c *Client) PersonCombinedCredits(ctx context.Context, id int64) (*PersonCombinedCredits, error)

+ type PersonCombinedCredits struct

+ Cast []PersonCredit

+ Crew []PersonCredit

+ ID int64

+ type PersonCredit struct

+ Character string

+ Department string

+ EpisodeCount int

+ Job string

v0.2.6

Oct 21, 2026

v0.2.5

Oct 21, 2026

v0.2.4

Oct 21, 2026

v0.2.3

Oct 20, 2026

v0.2.2

Oct 20, 2026

v0.2.1

Oct 20, 2026

v0.2.0

Oct 20, 2026

Changes in this version

+ const DefaultBaseURL

+ const MinClusterRate

+ const VideoBehindTheScenes

+ const VideoBloopers

+ const VideoClip

+ const VideoFeaturette

+ const VideoTeaser

+ const VideoTrailer

+ var BundledKey string

+ var ErrNoKey = errors.New("tmdb: no API key configured")

+ func IsBearerKey(key string) bool

+ func ParseDate(s string) time.Time

+ func ResolveKey(cfg config.Catalog) string

+ type CastMember struct

+ Character string

+ Department string

+ ID int64

+ Job string

+ Jobs []struct{ ... }

+ Name string

+ Order int

+ ProfilePath string

+ Roles []struct{ ... }

+ type Client struct

+ func New(key string, log *slog.Logger, opts ...Option) *Client

+ func NewFromConfig(cfg config.Catalog, log *slog.Logger, opts ...Option) *Client

+ func (c *Client) ArtworkVariants(ctx context.Context, t *core.Title, language string) (*Images, error)

+ func (c *Client) Close()

+ func (c *Client) CollectionDetails(ctx context.Context, id int64) (*CollectionDetails, error)

+ func (c *Client) Configuration(ctx context.Context) (*Configuration, error)

+ func (c *Client) DiscoverMovies(ctx context.Context, p DiscoverParams) (*Paged[Movie], error)

+ func (c *Client) DiscoverTV(ctx context.Context, p DiscoverParams) (*Paged[TVShow], error)

+ func (c *Client) EpisodeDetails(ctx context.Context, tvID int64, season, episode int) (*Episode, error)

+ func (c *Client) EpisodeExternalIDs(ctx context.Context, tvID int64, season, episode int) (*ExternalIDs, error)

+ func (c *Client) EpisodeGroup(ctx context.Context, id string) (*EpisodeGroup, error)

+ func (c *Client) EpisodeGroups(ctx context.Context, show int64) ([]EpisodeGroupSummary, error)

+ func (c *Client) EpisodeVideos(ctx context.Context, tvID int64, season, episode int, lang string) ([]Video, error)

+ func (c *Client) FindByExternalID(ctx context.Context, source, id string) (*FindResult, error)

+ func (c *Client) Genres(ctx context.Context, mediaType string) ([]Genre, error)

+ func (c *Client) GetJSON(ctx context.Context, path string, q url.Values, out any) error

+ func (c *Client) HasKey() bool

+ func (c *Client) ImageURL(path, size string) string

+ func (c *Client) ImageURLFunc() core.ImageURLFunc

+ func (c *Client) Language() string

+ func (c *Client) Localized(ctx context.Context, t *core.Title, language string) (*core.Title, error)

+ func (c *Client) MovieDetails(ctx context.Context, id int64) (*MovieDetails, error)

+ func (c *Client) MovieList(ctx context.Context, list string, page int) (*Paged[Movie], error)

+ func (c *Client) MovieRecommendations(ctx context.Context, id int64, page int) (*Paged[Movie], error)

+ func (c *Client) MovieSimilar(ctx context.Context, id int64, page int) (*Paged[Movie], error)

+ func (c *Client) MovieVideos(ctx context.Context, id int64, lang string) ([]Video, error)

+ func (c *Client) PersonDetails(ctx context.Context, id int64) (*Person, error)

+ func (c *Client) RateLimit() (perSec float64, burst int)

+ func (c *Client) Region() string

+ func (c *Client) SearchMovies(ctx context.Context, query string, page int) (*Paged[Movie], error)

+ func (c *Client) SearchMulti(ctx context.Context, query string, page int) (*Paged[MultiResult], error)

+ func (c *Client) SearchTV(ctx context.Context, query string, page int) (*Paged[TVShow], error)

+ func (c *Client) SeasonDetails(ctx context.Context, tvID int64, season int) (*SeasonDetails, error)

+ func (c *Client) SeasonVideos(ctx context.Context, tvID int64, season int, lang string) ([]Video, error)

+ func (c *Client) SetConfiguration(cfg *Configuration)

+ func (c *Client) SetRateShare(nodes int)

+ func (c *Client) TVDetails(ctx context.Context, id int64) (*TVDetails, error)

+ func (c *Client) TVList(ctx context.Context, list string, page int) (*Paged[TVShow], error)

+ func (c *Client) TVRecommendations(ctx context.Context, id int64, page int) (*Paged[TVShow], error)

+ func (c *Client) TVSimilar(ctx context.Context, id int64, page int) (*Paged[TVShow], error)

+ func (c *Client) TVVideos(ctx context.Context, id int64, lang string) ([]Video, error)

+ func (c *Client) TrendingAll(ctx context.Context, window string, page int) (*Paged[MultiResult], error)

+ func (c *Client) TrendingMovies(ctx context.Context, window string, page int) (*Paged[Movie], error)

+ func (c *Client) TrendingTV(ctx context.Context, window string, page int) (*Paged[TVShow], error)

+ func (c *Client) UpdateConfig(cfg config.Catalog)

+ type CollectionDetails struct

+ BackdropPath string

+ ID int64

+ Name string

+ Overview string

+ Parts []Movie

+ PosterPath string

+ type CollectionRef struct

+ BackdropPath string

+ ID int64

+ Name string

+ PosterPath string

+ type Company struct

+ ID int

+ LogoPath string

+ Name string

+ OriginCountry string

+ type Configuration struct

+ ChangeKeys []string

+ Images struct{ ... }

+ type ContentRatings struct

+ Results []struct{ ... }

+ type Country struct

+ ISO3166 string

+ Name string

+ type Credits struct

+ Cast []CastMember

+ Crew []CastMember

+ type DiscoverParams struct

+ Extra url.Values

+ FirstAirGTE string

+ FirstAirLTE string

+ IncludeAdult bool

+ Page int

+ Region string

+ ReleaseDateGTE string

+ ReleaseDateLTE string

+ SortBy string

+ VoteAverageGTE float64

+ VoteCountGTE int

+ WithGenres string

+ WithOriginalLanguage string

+ Year int

+ type Episode struct

+ AirDate string

+ Crew []CastMember

+ EpisodeNumber int

+ GuestStars []CastMember

+ ID int64

+ Name string

+ Overview string

+ Runtime *int

+ SeasonNumber int

+ ShowID int64

+ StillPath string

+ VoteAverage float64

+ VoteCount int

+ type EpisodeGroup struct

+ Groups []EpisodeSubgroup

+ type EpisodeGroupSummary struct

+ Description string

+ EpisodeCount int

+ GroupCount int

+ ID string

+ Name string

+ Type int

+ type EpisodeSubgroup struct

+ Episodes []OrderedEpisode

+ ID string

+ Name string

+ Order int

+ type ExternalIDs struct

+ FacebookID string

+ ID int64

+ IMDBID string

+ InstagramID string

+ TVDBID int64

+ TwitterID string

+ WikidataID string

+ type FindResult struct

+ MovieResults []Movie

+ PersonResults []Person

+ TVEpisodeResults []Episode

+ TVResults []TVShow

+ TVSeasonResults []SeasonSummary

+ type Genre struct

+ ID int

+ Name string

+ type GenreList struct

+ Genres []Genre

+ type HTTPError struct

+ Body string

+ StatusCode int

+ StatusMsg string

+ func (e *HTTPError) Error() string

+ func (e *HTTPError) Is(target error) bool

+ type ImageFile struct

+ FilePath string

+ Height int

+ ISO639 string

+ VoteAvg float64

+ Width int

+ type Images struct

+ Backdrops []ImageFile

+ Logos []ImageFile

+ Posters []ImageFile

+ Still []ImageFile

+ type Keyword struct

+ ID int

+ Name string

+ type Keywords struct

+ Keywords []Keyword

+ Results []Keyword

+ type Language struct

+ ISO639 string

+ Name string

+ type Movie struct

+ Adult bool

+ BackdropPath string

+ GenreIDs []int

+ Genres []Genre

+ ID int64

+ MediaType string

+ OriginalLanguage string

+ OriginalTitle string

+ Overview string

+ Popularity float64

+ PosterPath string

+ ReleaseDate string

+ Title string

+ VoteAverage float64

+ VoteCount int

+ type MovieDetails struct

+ BelongsTo *CollectionRef

+ Budget int64

+ Credits *Credits

+ ExternalIDs *ExternalIDs

+ Homepage string

+ IMDBID string

+ Images *Images

+ Keywords *Keywords

+ ProductionCompany []Company

+ ProductionCountry []Country

+ Recommendations *Paged[Movie]

+ ReleaseDates *ReleaseDates

+ Revenue int64

+ Runtime int

+ Similar *Paged[Movie]

+ SpokenLanguages []Language

+ Status string

+ Tagline string

+ type MultiResult struct

+ BackdropPath string

+ FirstAirDate string

+ GenreIDs []int

+ ID int64

+ MediaType string

+ Name string

+ OriginalLanguage string

+ OriginalName string

+ OriginalTitle string

+ Overview string

+ Popularity float64

+ PosterPath string

+ ProfilePath string

+ ReleaseDate string

+ Title string

+ VoteAverage float64

+ VoteCount int

+ func (m MultiResult) AsMovie() Movie

+ func (m MultiResult) AsTV() TVShow

+ type Network struct

+ ID int

+ Name string

+ type Option func(*options)

+ func WithBaseURL(u string) Option

+ func WithCacheTTL(d time.Duration) Option

+ func WithHTTPClient(c *http.Client) Option

+ func WithMaxRetries(n int) Option

+ func WithRateLimit(perSec float64, burst int) Option

+ func WithUserAgent(s string) Option

+ type OrderedEpisode struct

+ Order int

+ type Paged struct

+ Page int

+ Results []T

+ TotalPages int

+ TotalResults int

+ type Person struct

+ Biography string

+ Birthday string

+ Deathday string

+ ID int64

+ IMDBID string

+ KnownForDepartment string

+ Name string

+ PlaceOfBirth string

+ Popularity float64

+ ProfilePath string

+ type ReleaseDateEntry struct

+ Certification string

+ Note string

+ ReleaseDate string

+ Type int

+ type ReleaseDates struct

+ Results []struct{ ... }

+ type SeasonDetails struct

+ AirDate string

+ Episodes []Episode

+ ID int64

+ Name string

+ Overview string

+ PosterPath string

+ SeasonNumber int

+ VoteAverage float64

+ type SeasonSummary struct

+ AirDate string

+ EpisodeCount int

+ ID int64

+ Name string

+ Overview string

+ PosterPath string

+ SeasonNumber int

+ VoteAverage float64

+ type TVDetails struct

+ AggregateCredits *Credits

+ ContentRatings *ContentRatings

+ CreatedBy []struct{ ... }

+ Credits *Credits

+ EpisodeRunTime []int

+ ExternalIDs *ExternalIDs

+ Homepage string

+ Images *Images

+ InProduction bool

+ Keywords *Keywords

+ LastAirDate string

+ Networks []Network

+ NumberOfEpisodes int

+ NumberOfSeasons int

+ ProductionCompany []Company

+ ProductionCountry []Country

+ Recommendations *Paged[TVShow]

+ Seasons []SeasonSummary

+ Similar *Paged[TVShow]

+ Status string

+ Tagline string

+ Type string

+ type TVShow struct

+ Adult bool

+ BackdropPath string

+ FirstAirDate string

+ GenreIDs []int

+ Genres []Genre

+ ID int64

+ MediaType string

+ Name string

+ OriginCountry []string

+ OriginalLanguage string

+ OriginalName string

+ Overview string

+ Popularity float64

+ PosterPath string

+ VoteAverage float64

+ VoteCount int

+ type Video struct

+ ID string

+ ISO3166 string

+ ISO639 string

+ Key string

+ Name string

+ Official bool

+ PublishedAt string

+ Site string

+ Size int

+ Type string

+ func (v Video) Published() time.Time

+ type Videos struct

+ ID int64

+ Results []Video

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL