🎥 Movier: Lightweight IMDb scraping helpers for movies, series, and celeb data inside your Node.js app 🚀

🌟 Welcome to movier, an IMDb Data Scraping Library!

Note: We recommend not using this package directly in production, as it scrapes IMDB page content. Requests can take a couple of seconds to complete. Instead, use this package to fetch and cache the information in your local database for faster retrieval.

🛠️ Installation

Install movier using your preferred package manager:

Bun:

bun add @valhalladev/movier

Yarn:

yarn add @valhalladev/movier

npm:

npm install @valhalladev/movier --save

🚀 Usage

const movier = require("@valhalladev/movier");

Title details (movie/series)

Pull every detail from an IMDB title page—plot, ratings, cast, crew, release info, keywords, images, awards, and more.

movier.getTitleDetailsByName("interstellar 2014");
movier.getTitleDetailsByUrl("https://www.imdb.com/title/tt0816692/");
movier.getTitleDetailsByIMDBId("tt0816692");
movier.getTitleDetailsByFoundedTitleDetails(foundedDetails);

Each call resolves to a structured title object. See the example in examples/results/interstellarTitleResults.json for the full schema.

Search for titles

Search by name and receive match metadata (IMDB url, score, thumbnail) so you can select the correct entry before fetching the full payload.

movier.searchTitleByName("interstellar 2014");

Results match the shape shown in examples/results/interstellarTitleSearchResults.json.

Person (celebrity) details

Grab bios, birth info, filmography, personal details, and imagery for any celebrity page.

movier.getPersonDetailsByName("jennifer lawrence");
movier.getPersonDetailsByUrl("https://www.imdb.com/name/nm2225369/");
movier.getPersonDetailsByIMDBId("nm2225369");
movier.getPersonDetailsByFoundedPersonDetails(foundedDetails);

Each method resolves to a consistent person object. Reference examples/results/jenniferLawrencePersonResults.json for the payload structure.

Search for people

movier.searchPersonByName("jennifer lawrence");

Returns a shortlist of profiles with match scores and URLs (see examples/results/jenniferLawrencePersonSerachResults.json).

🧪 Test

Execute the test suite after installing dependencies:

bun test

🤝 Contributing

We welcome contributions that help movier stay useful and reliable. Before you start work, please review our CONTRIBUTING guide so you understand the workflow, Code of Conduct, and release expectations. Follow the listed steps (fork, branch, commit, push, open a PR) and keep your PR description detailed so reviewers can follow the changes you made.

📜 License

This project is licensed under the MIT License – feel free to fork, adapt, and redistribute with attribution.

🙏 Acknowledgements

• IMDb for the data that powers movier’s lookups
• Zoha for the original movier project and parser work
• Everyone who tests, files issues, or contributes to movier’s continued usefulness

📬 Support & Community

Got questions or need help? Join our Discord server for support and to connect with other bot developers!

💻 Crafted with ❤️ by Valhalla-Development & Zoha

🐛 Spotted an issue? | 💡 Got an idea? | 🤔 Need help?

🔝 Back to Top