| Name | imdbinfo JSON |
| Version |
0.3.2
JSON |
| download |
| home_page | None |
| Summary | A Python service for querying IMDb data |
| upload_time | 2025-07-25 21:31:51 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | None |
| license | None |
| keywords |
imdb
movie
information
data
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
[](https://github.com/tveronesi/imdbinfo/actions/workflows/pypi-publish.yml)
# imdbinfo
A Python package to fetch and manage IMDb movie information easily.
## Requirements
Python (3.7 or higher)
## Installation
`pip install imdbinfo`
## Usage
``` python
from imdbinfo.services import search_title, get_movie
# Search for a movie by title
results = search_title("The Matrix")
for movie in results.titles:
print(f"{movie.title} ({movie.year}) - {movie.imdb_id}")
```
Will output:
```
Matrix (1999) - 0133093
Matrix Reloaded (2003) - 0234215
Matrix Resurrections (2021) - 10838180
Matrix Revolutions (2003) - 0242653
The Matrix Recalibrated (2004) - 0410519
```
Dump the search results in JSON format, to see the full details of the search results:
``` python
print(results.model_dump_json())
```
Get detailed information about a movie by IMDb ID
``` python
# Get detailed information about a movie by IMDb ID
movie = get_movie("0133093")
print(f"Title: {movie.title}") # Title: The Matrix
print(f"Year: {movie.year}") # Year: 1999
print(f"Rating: {movie.rating}") # Rating: 8.7
print(f"Genres: {', '.join(movie.genres)}") # Genres: Action, Sci-Fi
print(f"Plot: {movie.plot}") # Plot: A computer hacker learns from mysterious rebels about the true nature of his reality and his role in the war against its controllers.
```
Dump the movie details in JSON format:
``` python
print(movie.model_dump_json())
```
## NEW FEATURES
Under `MovieDetail.categories` dictionary, you can find various categories of people involved in the movie production. The categories include:
* director
* writer
* cast
* producer
* composer
* cinematographer
* editor
* casting_director
* production_designer
* art_director
* set_decorator
* costume_designer
* make_up_department
* production_manager
* assistant_director
* art_department
* sound_department
* special_effects
* visual_effects
* stunts
* camera_department
* animation_department
* casting_department
* costume_department
* editorial_department
* location_management
* music_department
* script_department
* transportation_department
* miscellaneous
Each category contains a list of people involved in that role, in the format Model
Person(name='Keanu Reeves', id='nm0000206', url='https://www.imdb.com/name/nm0000206', job='Cast')
## Deprecation Notice
`MovieDetail.directors` and `MovieDetail.cast` have been deprecated in favor of the new categories structure: `MovieDetail.categories['director']` and `MovieDetail.categories['cast']` respectively.
Adding `MovieDetail.stars` as a new attribute to `MovieDetail` to replace the old `MovieDetail.cast` attribute.
The old attribute `MovieDetail.directors` will be removed in a future release and the attribute `MovieDetail.cast` will be renamed into `MovieDetail.stars` .
## License
This project is licensed under GPL v2.0 - see the [LICENSE](LICENSE) file for details.
## Contributing
Contributions are welcome! Please read the [CONTRIBUTING](CONTRIBUTING.md) file for details on how to contribute to this project.
## Issues
Raw data
{
"_id": null,
"home_page": null,
"name": "imdbinfo",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "imdb, movie, information, data",
"author": null,
"author_email": "\"@tveronesi\" <you@example.com>",
"download_url": "https://files.pythonhosted.org/packages/84/05/6f7959fd2784bc9e83e625044be3f5576835ebefff7433791ce8bfc3c75b/imdbinfo-0.3.2.tar.gz",
"platform": null,
"description": "\n[](https://github.com/tveronesi/imdbinfo/actions/workflows/pypi-publish.yml)\n# imdbinfo\n\nA Python package to fetch and manage IMDb movie information easily.\n\n## Requirements\n\nPython (3.7 or higher)\n\n## Installation\n\n`pip install imdbinfo`\n\n## Usage\n\n``` python\nfrom imdbinfo.services import search_title, get_movie\n\n# Search for a movie by title\nresults = search_title(\"The Matrix\")\nfor movie in results.titles:\n print(f\"{movie.title} ({movie.year}) - {movie.imdb_id}\")\n``` \nWill output:\n``` \nMatrix (1999) - 0133093\nMatrix Reloaded (2003) - 0234215\nMatrix Resurrections (2021) - 10838180\nMatrix Revolutions (2003) - 0242653\nThe Matrix Recalibrated (2004) - 0410519\n``` \n\nDump the search results in JSON format, to see the full details of the search results:\n\n``` python\nprint(results.model_dump_json())\n```\n\nGet detailed information about a movie by IMDb ID\n\n``` python\n# Get detailed information about a movie by IMDb ID\nmovie = get_movie(\"0133093\") \nprint(f\"Title: {movie.title}\") # Title: The Matrix\nprint(f\"Year: {movie.year}\") # Year: 1999\nprint(f\"Rating: {movie.rating}\") # Rating: 8.7\nprint(f\"Genres: {', '.join(movie.genres)}\") # Genres: Action, Sci-Fi\nprint(f\"Plot: {movie.plot}\") # Plot: A computer hacker learns from mysterious rebels about the true nature of his reality and his role in the war against its controllers.\n``` \n\nDump the movie details in JSON format:\n\n``` python\nprint(movie.model_dump_json())\n```\n\n## NEW FEATURES\n\nUnder `MovieDetail.categories` dictionary, you can find various categories of people involved in the movie production. The categories include:\n\n* director\n* writer\n* cast\n* producer\n* composer\n* cinematographer\n* editor\n* casting_director\n* production_designer\n* art_director\n* set_decorator\n* costume_designer\n* make_up_department\n* production_manager\n* assistant_director\n* art_department\n* sound_department\n* special_effects\n* visual_effects\n* stunts\n* camera_department\n* animation_department\n* casting_department\n* costume_department\n* editorial_department\n* location_management\n* music_department\n* script_department\n* transportation_department\n* miscellaneous\n\nEach category contains a list of people involved in that role, in the format Model \n\n Person(name='Keanu Reeves', id='nm0000206', url='https://www.imdb.com/name/nm0000206', job='Cast')\n\n## Deprecation Notice\n\n`MovieDetail.directors` and `MovieDetail.cast` have been deprecated in favor of the new categories structure: `MovieDetail.categories['director']` and `MovieDetail.categories['cast']` respectively.\n\nAdding `MovieDetail.stars` as a new attribute to `MovieDetail` to replace the old `MovieDetail.cast` attribute.\n\nThe old attribute `MovieDetail.directors` will be removed in a future release and the attribute `MovieDetail.cast` will be renamed into `MovieDetail.stars` .\n\n\n\n## License\nThis project is licensed under GPL v2.0 - see the [LICENSE](LICENSE) file for details.\n## Contributing\nContributions are welcome! Please read the [CONTRIBUTING](CONTRIBUTING.md) file for details on how to contribute to this project.\n## Issues\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python service for querying IMDb data",
"version": "0.3.2",
"project_urls": null,
"split_keywords": [
"imdb",
" movie",
" information",
" data"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5b7491039f12e9e0e0164424e3c5818838f53a7bb4a956dc66633f4dbaacfc4f",
"md5": "c6f6e6c178bd2930833a0179fb9f1a24",
"sha256": "da0f27dbc859cb2bcf5068395661b5e3fce9e80c9fac4f7078995f02cb671f31"
},
"downloads": -1,
"filename": "imdbinfo-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c6f6e6c178bd2930833a0179fb9f1a24",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 13984,
"upload_time": "2025-07-25T21:31:49",
"upload_time_iso_8601": "2025-07-25T21:31:49.840191Z",
"url": "https://files.pythonhosted.org/packages/5b/74/91039f12e9e0e0164424e3c5818838f53a7bb4a956dc66633f4dbaacfc4f/imdbinfo-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "84056f7959fd2784bc9e83e625044be3f5576835ebefff7433791ce8bfc3c75b",
"md5": "34b9e5564e3ac76936a6a206d4c7cd1e",
"sha256": "64faf454d4bb682f363d02c0269e8d608bee7e6118bfe79e95d0c538539b4677"
},
"downloads": -1,
"filename": "imdbinfo-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "34b9e5564e3ac76936a6a206d4c7cd1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 470898,
"upload_time": "2025-07-25T21:31:51",
"upload_time_iso_8601": "2025-07-25T21:31:51.040838Z",
"url": "https://files.pythonhosted.org/packages/84/05/6f7959fd2784bc9e83e625044be3f5576835ebefff7433791ce8bfc3c75b/imdbinfo-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 21:31:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "imdbinfo"
}
