tmdbsimple

library2.9.6pypypi✓ verified 85d ago

A lightweight Python wrapper for The Movie Database (TMDb) API v3. Version 2.9.6 requires Python 3.9+. Releases are infrequent, primarily bugfixes.

pip install tmdbsimple

github ↗homepage ↗

INSTALL

IMPORT

SIG · TMDBSIMPLE

tmdbsimple

searchpythonv2.9.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

tmdb

✓ import tmdbsimple as tmdb

Initialize with API key, fetch movie info by ID.

import os import tmdbsimple as tmdb tmdb.API_KEY = os.environ.get('TMDB_API_KEY', '') movie = tmdb.Movies(550) response = movie.info() print(response['original_title'])

Debug

Known issues

deprecatedtmdb.API_KEY is deprecated; use tmdb.API_KEY = 'your_key' directly or set environment variable. Future versions may remove the property.

fix

Set tmdb.API_KEY as an attribute explicitly.

affects: >=2.9.0

gotchaAPI key required before any request; library does not raise clear error if missing.

fix

Always set tmdb.API_KEY = 'your_key' or ensure TMDB_API_KEY env var is set.

affects: all

breakingPython 3.9+ required as of 2.9.6; Python 3.7/3.8 compatibility dropped.

fix

Upgrade to Python 3.9 or higher, or pin to an earlier version like 2.8.4.

affects: >=2.9.6

Errors

Common errors & fixes

AttributeError: module 'tmdbsimple' has no attribute 'API_KEY'

Imported wrong object; correct attribute is tmdb.API_KEY, but must be set on the module.

fix

Ensure you do `import tmdbsimple as tmdb` then `tmdb.API_KEY = 'key'`.

requests.exceptions.HTTPError: 401 Client Error: Unauthorized

Invalid or missing API key.

fix

Set a valid TMDb API v3 key via tmdb.API_KEY or environment variable TMDB_API_KEY.

ImportError: No module named 'requests'

Missing dependency requests.

fix

Install with `pip install requests` or reinstall tmdbsimple.

Upgrade

Version history

2.9.6latest on PyPI · released May 25, 2026

Audit

Dependencies

requestsrequiredHTTP client for API calls

Agent activity

36 hits · last 30 days

node

Resources

githubhttps://github.com/celiao/tmdbsimple ↗

homepagehttps://github.com/celiao/tmdbsimple ↗