/imdb-series-scraper

IMDb Series Scraper is a Python script designed to scrape episode data from IMDb for a given TV series. It fetches details such as episode titles, thumbnails, and descriptions, and saves them in a JSON file.

Primary LanguagePythonMIT LicenseMIT

IMDb Series Scraper

IMDb Series Scraper is a Python script designed to scrape episode data from IMDb for a given TV series. It fetches details such as episode titles, thumbnails, and descriptions, and saves them in a JSON file.

Demo video

Project Structure

.
├── README.md
├── main.py
└── requirements.txt

Dependencies

The project dependencies are listed in the requirements.txt file. They include:

  • beautifulsoup4
  • requests

Installation

  1. Clone the repository

    git clone https://github.com/Odisseu93/imdb-series-scraper
cd imdb-series-scraper

  2. Create and activate a virtual environment (optional but recommended)

    python -m venv venv
source venv/bin/activate   # On Windows, use `venv\Scripts\activate`

  3. Install the required packages

    pip install -r requirements.txt

Usage

To run the script, execute the following command:

python main.py

Follow the on-screen prompts to search for a series or get episode data for a specific series by its IMDb ID.

Menu Options

  1. Find series: Search for TV series on IMDb by entering a query.
  2. Get series data: Enter the IMDb ID of a series to fetch and save its episode data in a JSON file.
  3. Exit: Exit the script.

Example Workflow

  1. Find a series:

    • Select option 1 and enter a search query.
    • The script will display a list of series with their respective IMDb IDs.

  2. Get series data:

    • Select option 2 and enter the IMDb ID of the desired series (e.g., tt0386676).
    • The script will fetch the episode data for all seasons and save it in a JSON file named after the series in the data directory.

Output

The script creates a directory named data (if it doesn't already exist) and saves the scraped episode data in a JSON file with the following structure:

[
    {
        "title": "series_name"
    },
    {
        "season_number": 1,
        "episodes": [
            {
                "title": "Episode 1",
                "thumbnail": "url_to_thumbnail",
                "description": "Episode description"
            },
            ...
        ]
    },
    ...
]

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments