PHPackages                             esenliyim/listimporter - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. esenliyim/listimporter

ActiveLibrary[Utility & Helpers](/categories/utility)

esenliyim/listimporter
======================

Import lists from various websites

05PHP

Since Apr 24Pushed 4y ago1 watchersCompare

[ Source](https://github.com/esenliyim/listimporter)[ Packagist](https://packagist.org/packages/esenliyim/listimporter)[ RSS](/packages/esenliyim-listimporter/feed)WikiDiscussions master Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

listimporter
============

[](#listimporter)

Imports user (watch)lists from imdb.

About
-----

[](#about)

The `listimporter` package allows you to import the contents of publicly visible user lists from IMDb.

Features
--------

[](#features)

- Creates a container that contains all the titles from the specified list.
- Can fetch a user's watchlist
- Can filter the list by title type (movie, short, tv episode, etc...). Offers preset filters as well as the option to manually specify title types.
- Can filter unreleased or upcoming titles
- Can filter by genre, returning titles that either contain all of the specified genres or any of them
- Can skip marshaling the list items into an array of film objects and get it as a 2D array of strings instead

Notes
-----

[](#notes)

Can take several seconds to import a list when initialized with a user ID. That's because it requires 2 HTTP requests compared to the single one when importing directly via listId, and IMDb can take a while to respond to that one particular extra request. Providing the watchlist's listId will make it significantly faster, if you have the ID of course.

If you have access to the account that owns the watchlist, you can get the watchlist's listId by clicking 'EDIT' on IMDb. The URL in the browser's address bar will then contain the listId.

Example usage
-------------

[](#example-usage)

```
use Esenliyim\Listimporter\ListImporter;

// To import via listId
$listIdImporter = new ListImporter("");
$importedFromListId = $importer->fetchList();

$films = $importedFromListId->filmsOnly();

// Or via user ID
$userIdImporter = new ListImporter("");
$importedFromUserId = $importer->fetchList();

$upcoming = $importedFromUserId->upcomingOnly();

// multiple filters
$upcomingWarShorts = $importedFromUserId
    ->setReleaseFiter(false)
    ->setTypeFiter('short')
    ->setGenreFilter(['War'])
    ->getFiltered();
```

composer
--------

[](#composer)

SOON™

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity26

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/33372147?v=4)[Emre Senliyim](/maintainers/esenliyim)[@esenliyim](https://github.com/esenliyim)

---

Top Contributors

[![esenliyim](https://avatars.githubusercontent.com/u/33372147?v=4)](https://github.com/esenliyim "esenliyim (12 commits)")

### Embed Badge

![Health badge](/badges/esenliyim-listimporter/health.svg)

```
[![Health](https://phpackages.com/badges/esenliyim-listimporter/health.svg)](https://phpackages.com/packages/esenliyim-listimporter)
```

###  Alternatives

[lovata/oc-toolbox-plugin

Toolbox plugin for October CMS

3812.1k](/packages/lovata-oc-toolbox-plugin)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)