# cinemagoer/cinemagoer

Cinemagoer is a Python package useful to retrieve and manage the data of the IMDb (to which we are not affiliated in any way) movie database about movies, people and characters

Repository: https://github.com/cinemagoer/cinemagoer
Canonical: https://ross.abutalabs.com/products/cinemagoer
Homepage: https://cinemagoer.github.io/
Language: HTML
License: GPL-2.0
License Family: copyleft
Topics: imdb, movies, actors, cinema, movie-database, python, database, sql, cast, internet-movie-database, character, company, movie, db, parser, scraper, cinemagoer
Last push: 2026-08-25T15:52:53+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 86, longevity 100
- inputs: {"age_days": 5876, "days_push": 8, "days_rel": 13, "gap_med": 54, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1323, forks 376 (observed 2026-08-28T04:04:22.208780+00:00)

## What it is
Cinemagoer (formerly IMDbPY) is a Python package for retrieving and managing IMDb data about movies, people, characters, and companies from IMDb's non-commercial downloadable TSV datasets. It provides a simple API over a local database (SQLite by default, or any SQLAlchemy-supported database) populated from the IMDb datasets.

## Use cases
- query imdb movie data from python
- search for people and movies by name
- import imdb tsv datasets into a local sqlite database
- get directors, cast, and genres of a movie programmatically
- build a local movie database for an app
- analyze imdb datasets for research

## When to choose
- you need programmatic access to IMDb data offline from a local database
- you want a mature Python API over the free IMDb datasets
- you need SQLite or SQLAlchemy-backed storage of movie/person data

## When to avoid
- you need to parse live IMDb web pages (use cinemagoerng instead)
- you need real-time data not present in the periodic dataset dumps
- you require a license other than GPL-2.0

## Facets
- artifact type: library
- maturity: active
- function: database, parser, web-scraping, search-engine, sdk
- domain: databases, entertainment, developer-tools
- platform: python, cross-platform
- tags: imdb, movies, movie-database, sql, sqlite, sqlalchemy, tsv-datasets, cinema, data-engineering

## Member repositories
- cinemagoer/cinemagoer (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:22.208780+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:47:04.272481+00:00, confidence not recorded.
  - readme: https://github.com/cinemagoer/cinemagoer (fetched 2026-08-28T04:04:22.208780+00:00, sha 363db70fe463)
  - homepage: https://cinemagoer.github.io/ (fetched 2026-08-29T12:05:49.327045+00:00, sha 1c2114581ba8)
- Data as of 2026-08-30T08:39:29.467469+00:00.