[REL] IMDB ( via API )

[Munkey]

Alternative IMDb script to get info from original API. Aims to be simpler, faster & reliable.

Download from: https://github.com/Purfview/IMDB_ALT

Version Log:

Code: Select all

2.1.0 - (2026/01/31) - Fixed: AKAs didn't import a primary title.

2.0.0 - (2026/01/30) - New feature: New parameter 'userCountryCode'. Affects Translated Title, Trivia, Certification...
                       New feature: New option 'AKAs'. [ignores dupes and the titles with unrecognized chars]
                       Improvement: Import a category and other stuff for Trivia.
                       Improvement: Added safety in dedot for the titles containing dots originally.
                       Improvement: Added support for a year in brackets. ['SearchWithYear']
                       Fixed: Attribute wasn't added if there was no character for an actor. ['GetCharacters']
                       
1.5.1 - (2026/01/27) - Improvement: Import attributes too when GetCharacters is enabled. [voice, uncredited, ect.]
                       Improvement: Remove escapes from tagline.
                       Improvement: Replace 'null' with 'x' if authorRating is not set in a comment.
                       
1.5.0 - (2026/01/27) - New feature: Added Replace_delimiter parameter
                       New feature: Added Trivia importing
                       
1.4.0 - (2026/01/25) - Fixed: Issues passing unicode chars in query with PostPage3() [returns nothing in normal search]
                              Solution: Fix the titles with UTF8EncodeToUnicodeEscapes()
                              The title examples to test:
                              "Schönberg" (www.imdb.com/title/tt0100560)
                              "Les Misérables" (www.imdb.com/title/tt1707386) [user report, but worked for me]
                              
1.3.0 - (2025/12/04) - Regression bugfix: 1.1.0 broke "More options for ImageSize" [1.0.9]

1.2.0 - (2025/12/03) - New feature: Added fuzzy search. [can be enabled with 'SearchMethod' option]
                     - Improvement: Changed default ImageSize to 3.
                     
1.1.0 - (2025/07/06) - Improvement: Get the most helpful review instead of "featured" nonsense.
                     - Moved less important options to the bottom.
                     - Remove the escapes from Description.
                     
1.0.9 - (2025/07/05) - Improvement: More options for ImageSize.

1.0.8 - (2025/07/05) - Improvement: Optimized some code - now the script is 4 times faster.

1.0.7 - (2025/07/04) - Improvement: If alt versions available then add all runtimes to Description.
                     - Fixed bug with Comments field.
                     
1.0.6 - (2025/07/02) - Fixed rare Cloudflare/API timeout bug by changing a credits endpoint to a faster one.
                     - Reworked all credits.
                     - Renamed CreditsLimit to ActorsLimit.
                     - Added support to pair the actors with the characters. [GetCharacters option]
                     - Improvement: Adds tagline to Description.
                     
1.0.5 - (2025/06/29) - Added support for "My ratings" field. [IMDB_userID must be set]
                     - Added CreditsLimit option.
                     - Reworked Director/Writer/Actors.
                     - Fixed country errors: 'West Germany','East Germany','Soviet Union','Czechoslovakia',
                                             'Yugoslavia','Zaire','Serbia and Montenegro','Burma'.
                     - Fixed country names: 'Vietnam', 'Czech Republic'.
                     - Fixed: The title search didn't include the adult titles.
                     - Fixed few other bugs.
                     
1.0.4 - (2025/06/29) - Added support for Producer & Composer fields.
                     - Fixed few bugs.
                     
1.0.3 - (2025/06/27) - Fixed: BatchMode 1/2 wasn't working properly.
                     - Auto-remove dots from the titles as IMDb's advanced search doesn't like them
                     - Removed unneeded scripts from "uses".
                     
1.0.2 - (2025/06/27) - Fixed few country names
                     - Remove the escapes from Comment

1.0.1 - (2025/06/27) - File changed to UTF8 [note: AMC does not support UTF8, use UTF8Decode]
                     - The scripts title changed to "IMDB ( via API )"

1.0.0 - (2025/06/26) - The first public release.

Notes:
Can search by year, add it at the end of a title, for example: The.Platform.2.2024 or The Platform 2 2024 or The Platform 2 (2024)

Please report if something doesn't work.

[Lemaireus]

What is missing:
Support for Producer and Composer fields is missing, does anyone need them?

Yes, please. A fully functional script should be able to import all the fields. Will give this one a run through once it covers all the fields.

Thank you very much for your work.

[antp]

Thanks
It is indeed much simplier than parsing the pages. We'll see how long this API stays available.
I would change the title to "IMDb (via API)" or something like that.
I also included the licence text directly in the script's Licence property, rather than just "MIT".
I've included it on https://update.antp.be/amc/scripts/
I'll try to update these two properties on Github too.

[antp]

The time I create a github account and install software locally I see you already changed it on the server
I would remove the spaces inside parenthesis though, as otherwise it clashes with the existing "IMDB (Actor images)" script.

[Munkey]

Thanks
It is indeed much simplier than parsing the pages. We'll see how long this API stays available.

You are welcome!
It's up for few years, so I hope they will not obfuscate access to it.

The time I create a github account and install software locally I see you already changed it on the server

Yeah I updated it (changed the file to UTF8 too), you don't need to install Git, I just edit it directly in the website if it's quick edit, or just drag and drop whole edited file there, Git is just too much to bother with small projects.

I would remove the spaces inside parenthesis though, as otherwise it clashes with the existing "IMDB (Actor images)" script.

How and why it clashes?

Yes, please. A fully functional script should be able to import all the fields.

OK, I'll check if I can find the endpoints for that info, IMDb's API isn't publicly documented.

[antp]

How and why it clashes?

Visually, having in the list:

IMDB
IMDB (Actor images)
IMDB ( via API )

together looks strange, but I'm maybe a typography maniac/nerd

Yeah I updated it (changed the file to UTF8 too), you don't need to install Git, I just edit it directly in the website if it's quick edit, or just drag and drop whole edited file there, Git is just too much to bother with small projects.

Good to know
About the UTF8 conversion, AMC does not support it, so you get non-decoded UTF8 country names then (could be converted with UTF8Decode when retrieving the value from ExpandCountryCode)

[Munkey]

together looks strange, but I'm maybe a typography maniac/nerd

Looks OK for me as it is.

About the UTF8 conversion, AMC does not support it...

Thanks for info, fixed those few country names in v1.0.2

[Munkey]

Yes, please. A fully functional script should be able to import all the fields. Will give this one a run through once it covers all the fields.

v1.0.4 should support all fields. Please report if something is not working.

[Lemaireus]

v1.0.4 should support all fields. Please report if something is not working.

Works like lightning! The script is fast as well as accurate. It imports both the producer as well as the composer fields as also all the others.

The only bit missing for me now is:
1. The script imports only four actors. It would be great to have the option/s to import ten, or fifteen, or all, as one could in the earlier IMDB script.
2. The earlier IMDB script also allows us to import the names of the characters along with the actors in the following format. For example, for the film 'Zulu' (https://www.imdb.com/title/tt0058777):

Stanley Baker ... Lt. John Chard
Jack Hawkins ... Rev. Otto Witt
Ulla Jacobsson ... Margareta Witt
James Booth ... Pvt. Henry Hook
Michael Caine ... Lt. Gonville Bromhead
Nigel Green ... Color Sgt. Bourne
Ivor Emmanuel ... Pvt. Owen
Paul Daneman ... Sgt. Maxfield
Glynn Edwards ... Cpl. Allen
Neil McCarthy ... Pvt. Thomas

It would be great to have the option to have (I'm quoting from the earlier script option): "4-> Actor names like on IMDB page, with "..." between names and roles, and separated by line breaks". Please take a look at the "ActorsLayout" and "AllActors" options of the earlier IMDB script and you'll be able to see the options that I am referring to.

Also, it'll be great to have the option to import the tag line before the description in the 'description' field.

All the other elements in the script work exactly as they should and, I repeat, the script is blazingly fast.

[Dorohedoro]

Nice project thanks!. If you could add the option to import user votes for the ratings please!

I'm doing it with a personal script based on the official imdb script (on the subtitle field) and the result is like this:



for me user votes are really important!

[Lemaireus]

Got one error today on importing from https://www.imdb.com/title/tt0067778/. The third country, which should have been West Germany, was imported as 'XWG', and the script said, "Error: Unknown country code! Please report the error."

[Munkey]

New version:

Code: Select all

1.0.5 - (2025/06/29) - Added support for "My ratings" field. [IMDB_userID must be set]
                     - Added CreditsLimit option.
                     - Reworked Director/Writer/Actors.
                     - Fixed country errors: 'West Germany','East Germany','Soviet Union','Czechoslovakia',
                                             'Yugoslavia','Zaire','Serbia and Montenegro','Burma'.
                     - Fixed country names: 'Vietnam', 'Czech Republic'.
                     - Fixed: The title search didn't include the adult titles.
                     - Fixed few other bugs.

Interestingly, when I was repeatedly running various tests I was temp banned from API on these titles (Only on those IDs, else still works!):
https://www.imdb.com/title/tt2306299/ - Vikings
https://www.imdb.com/title/tt0944947/ - Game of Thrones

Still no idea why and how, I tried to reproduce ban by removing all ratelimits on other IDs but I couldn't reproduce it.
So, can anyone try these IDs like 3 times or more in row with BatchMode > 0 and enabled IMDB_userID (your personal ratings), report the outcome.

Temp ban indicator -> you get 504 "Timeout" error.

Got one error today on importing from https://www.imdb.com/title/tt0067778/. The third country, which should have been West Germany, was imported as 'XWG', and the script said, "Error: Unknown country code! Please report the error."

Fixed in v1.0.5, thanks for the report.

The only bit missing for me now is:
1. The script imports only four actors. It would be great to have the option/s to import ten, or fifteen, or all, as one could in the earlier IMDB script.
2. The earlier IMDB script also allows us to import the names of the characters along with the actors in the following format.

1) Added CreditsLimit option in v1.0.5.
2) I'll think about it.

Also, it'll be great to have the option to import the tag line before the description in the 'description' field.

Probably I'll add it to the next version.

Nice project thanks!. If you could add the option to import user votes for the ratings please!

Added support for it in v1.0.5.

[Lemaireus]

So, can anyone try these IDs like 3 times or more in row with BatchMode > 0 and enabled IMDB_userID (your personal ratings), report the outcome.

Temp ban indicator -> you get 504 "Timeout" error.

I am not registered on IMDB so I did not enable the user ID, but my batchmode is set to 0 and I got the 504 gateway time-out error on both the titles that you referred to the very first time I tried importing information for them. Other titles continue to work fine.

I was about to suggest adding another function to the script--importing information by supplying the IMDB URL to the script, which can be useful in cases in which the script might have a hard time finding a specific title--but I see that the script already successfully imports all the information when one supplies it with the URL of a title.

Waiting for the [actor ... character] format and the tagline import now. All else is in order for me (and the mystery of the 'Vikings' and the 'Game of Thrones' titles remains).

Once again, thank you for some wonderful work.

[Munkey]

I am not registered on IMDB so I did not enable the user ID, but my batchmode is set to 0 and I got the 504 gateway time-out error on both the titles that you referred to the very first time I tried importing information for them. Other titles continue to work fine.

Thanks for the test, that tells me a lot, I was wrong about "ban" because at first I got response from Vikings...
It looks like Cloudflare misconfiguration, if it doesn't get response from server in 16s then it produces the timeout error.
These titles have huge cast (that's why I tested them), so API server spends more time processing it, I'll think about implementing some fallback in such case.

[Munkey]

Waiting for the [actor ... character] format and the tagline import now.

Both features are implemented now:

Code: Select all

1.0.6 - (2025/07/02) - Fixed rare Cloudflare/API timeout bug by changing a credits endpoint to a faster one.
                     - Reworked all credits.
                     - Renamed CreditsLimit to ActorsLimit.
                     - Added support to pair the actors with the characters. [GetCharacters option]
                     - Improvement: Adds tagline to Description.

[Lemaireus]

Both features are implemented now:

I ran the script with a couple of titles--including 'Vikings' which wasn't working earlier--and it works perfectly: smooth, fast, accurate. Thank you for some splendid work.

[Lemaireus]

Both features are implemented now:

Code: Select all

1.0.6 - (2025/07/02) - Fixed rare Cloudflare/API timeout bug by changing a credits endpoint to a faster one.
                     - Reworked all credits.
                     - Renamed CreditsLimit to ActorsLimit.
                     - Added support to pair the actors with the characters. [GetCharacters option]
                     - Improvement: Adds tagline to Description.

Munkey, would it be possible to incorporate one more feature in your wonderful script, please?: It would be great if the script could import "runtime/s" of the movies because that helps one correctly label theatrical releases, director's cuts, unrated cuts, etc. The "runtime" information could be imported in the 'Description' box, right after the description ends: end of description, one line space, runtime information (in cases where the movie has different cuts, e.g., Apocalypse Now: Runtime: 2h 27m (147 min), 5h 30m (330 min) (Workprint Version), 3h 2m (182 min) (Final Cut), 3h 22m (202 min) (Redux Edition)).

I should also note that your script formats the text in the 'Comments' field correctly, with space between paragraphs, while the original IMDB script does not do that. Thank you for making sure that the formatting remains accurate.

[Munkey]

Munkey, would it be possible to incorporate one more feature in your wonderful script, please?: It would be great if the script could import "runtime/s" of the movies because that helps one correctly label theatrical releases, director's cuts, unrated cuts, etc.

Added this feature in v1.0.7.

I should also note that your script formats the text in the 'Comments' field correctly, with space between paragraphs, while the original IMDB script does not do that. Thank you for making sure that the formatting remains accurate.

There is one issue with the reviews that I don't like. IMDb replaced helpful reviews with some "featured" reviews nonsense, the top review can be even some bullshit with "negative" helpfulness...

[Munkey]

If you thought it was very fast before, try it now.

Code: Select all

1.0.8 - (2025/07/05) - Improvement: Optimized some code - now the script is 4 times faster.

[Dorohedoro]

If you thought it was very fast before, try it now.

Code: Select all

1.0.8 - (2025/07/05) - Improvement: Optimized some code - now the script is 4 times faster.

Thank you so much!!

I don't know if I'm doing something wrong but your script is not importing the Video Format

Also, could you add more options into the imagesize to get posters with much more quality? I'm used to get high quality postes from the other imdb script with imagekind=3 and LargePictureHeight=2160 and with your script the image even selecting 1500px seem low quality to me (pixelated). I need your images because with the other script I'm getting the local poster based on the user IP, your script is perfect because it gives me the original english poster.

Again, thank you so much for your amazing work!

EDIT: and sorry to bother you because this is a personal request, but, could you please share with me a small piece of code to extract the amount of votes and add them in the subtitles field? thanks!