PHPackages                             aalfiann/imdb-engine - 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. [API Development](/categories/api)
4. /
5. aalfiann/imdb-engine

ActiveLibrary[API Development](/categories/api)

aalfiann/imdb-engine
====================

An IMDB Scrapper like you have your own imdb engine.

1.1.0(7y ago)1221MITPHPPHP >=7.1.3

Since Sep 20Pushed 7y ago1 watchersCompare

[ Source](https://github.com/aalfiann/imdb-engine)[ Packagist](https://packagist.org/packages/aalfiann/imdb-engine)[ RSS](/packages/aalfiann-imdb-engine/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (4)Versions (11)Used By (0)

IMDB Engine
===========

[](#imdb-engine)

[![Version](https://camo.githubusercontent.com/7dc6863f36ec9b729b3321b1ecd426f73dfe1c742c8f483ffd46290a4fec8e2b/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c61746573742d312e312e302d677265656e2e737667)](https://github.com/aalfiann/imdb-engine)[![Total Downloads](https://camo.githubusercontent.com/fdb5c4fc72bc79a3262b1d9b81b370d53fa3a86721da4225ac978849f9560d6b/68747470733a2f2f706f7365722e707567782e6f72672f61616c6669616e6e2f696d64622d656e67696e652f646f776e6c6f616473)](https://packagist.org/packages/aalfiann/imdb-engine)[![License](https://camo.githubusercontent.com/2fe6033e63b2bf9cd71a47393524135e3c045fb26df316ec663a10e4a320b260/68747470733a2f2f706f7365722e707567782e6f72672f61616c6669616e6e2f696d64622d656e67696e652f6c6963656e7365)](https://github.com/aalfiann/imdb-engine/blob/HEAD/LICENSE.md)

An IMDB Scrapper like you have your own imdb engine.

*This script is a proof of concept. It’s working, but you shouldn’t use it. IMDb doesn’t allow this method of data fetching. I do not use or promote this script. You’re responsible for using it.*

The technique used is called “web scraping.” Which means, if IMDb changes any of their HTML, the script is going to fail. I won’t update this on a regular basis, so don’t count on it to be working all the time.

Installation
------------

[](#installation)

Install this package via [Composer](https://getcomposer.org/).

```
composer require "aalfiann/imdb-engine:^1.0"

```

Get Movies by ID
----------------

[](#get-movies-by-id)

```
require_once ('vendor/autoload.php');
use \aalfiann\IMDB;

$imdb = new IMDB();
$imdb->query    = 'tt3829266';      // ID IMDB Movie {required}
$imdb->trailer  = false;            // This will make faster because there is no second request to get video trailer. Default value is true.
echo var_dump($imdb->find()->getMovie());
```

Make output into JSON

```
header('Content-Type: application/json');
echo $imdb->find()->getMovieJson(JSON_PRETTY_PRINT);
```

Search Movies
-------------

[](#search-movies)

```
require_once ('vendor/autoload.php');
use \aalfiann\IMDB;

$imdb = new IMDB();
$imdb->query    = 'The Predator';   // Movie title {not required}. If blank then will show the new popular movies. The title must be don't include year or only conjunctions.
$imdb->genres   = '';               // You can filter by input multiple genres with commas separated
$imdb->userid   = '';               // You can filter by input user id. Ex. Jackie Chan user id is >> nm0000329
$imdb->start    = 1;                // Start number for navigation in many results.
$imdb->itemsperpage = 50;           // You can change this with 50, 100 and 250. Default is 50.
echo var_dump($imdb->search()->getList());
```

Make output into JSON

```
header('Content-Type: application/json');
echo $imdb->search()->getListJson(JSON_PRETTY_PRINT);
```

Search Artist to get user id
----------------------------

[](#search-artist-to-get-user-id)

```
require_once ('vendor/autoload.php');
use \aalfiann\IMDB;

$imdb = new IMDB();
$imdb->query = 'Audrey Hepburn';    // Artist name {required}
$imdb->start = 1;                   // Start number for navigation in many results.
$imdb->itemsperpage = 50;           // You can change this with 50, 100 and 250. Default is 50.
echo var_dump($imdb->searchArtist()->getArtistList());
```

Make output into JSON

```
header('Content-Type: application/json');
echo $imdb->searchArtist()->getArtistListJson(JSON_PRETTY_PRINT);
```

Use Proxy
---------

[](#use-proxy)

If your ip address has blocked by IMDB, you can make request with proxy.
Just add this line:

```
$imdb->proxy = '12.62.65.30:8124';  // IP:Port server proxy
$imdb->proxyauth = 'user:pass';     // Proxy authentication if any
```

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity63

Established project with proven stability

 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.

###  Release Activity

Cadence

Every ~5 days

Recently: every ~10 days

Total

10

Last Release

2744d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c101f6be505e4713be942f6b80d849b46702e6f4069430e1dbbe60fa18289c54?d=identicon)[aalfiann](/maintainers/aalfiann)

---

Top Contributors

[![aalfiann](https://avatars.githubusercontent.com/u/9458941?v=4)](https://github.com/aalfiann "aalfiann (16 commits)")

---

Tags

apiengineimdb

### Embed Badge

![Health badge](/badges/aalfiann-imdb-engine/health.svg)

```
[![Health](https://phpackages.com/badges/aalfiann-imdb-engine/health.svg)](https://phpackages.com/packages/aalfiann-imdb-engine)
```

###  Alternatives

[binarytorch/larecipe

Generate gorgeous recipes for your Laravel applications using MarkDown

2.5k2.7M16](/packages/binarytorch-larecipe)[sleeping-owl/apist

Package to provide api-like access to foreign sites based on html parsing

3105.3k](/packages/sleeping-owl-apist)[fabianbeiner/php-imdb-grabber

This PHP library enables you to scrape data from IMDB.com.

2764.8k1](/packages/fabianbeiner-php-imdb-grabber)[hmerritt/imdb-api

IMDB API that can fetch film data and search results

6911.3k](/packages/hmerritt-imdb-api)[nucleos/lastfm

Last.fm webservice client for php.

1812.9k2](/packages/nucleos-lastfm)

PHPackages © 2026

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