API Documentation

COMING SOON

New features and improvements are displayed here for preview purposes only.

This page is not intended for regular use and the listed features are currently unavailable.


API Settings

Please enter a valid API Key.
You can find your API key on your profile page.

Keep your API key secure and do not share it publicly. If your key is compromised, please contact support to request a new API key.

Notes

  • All API endpoints are case-insensitive. You can use endpoint names in any case format (e.g., Search, search, or SEARCH).
  • All API requests use the HTTP GET method.
  • All requests return HTTP status code 200 OK, even when an error occurs. Always check the success field to determine whether the request was successful. If success is false, the error details will be available in the errorMessage field.
  • All responses are returned in JSON format.

 Searches

Search Title

Search across all available titles including movies, TV series, episodes, and other title types. This endpoint is useful when you are not sure about the title type. For more accurate results, use Search-Movie for movies and Search-TVSeries for TV series when the title type is known.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find titles. You can search by title name, keywords, or title name with release year to improve accuracy. Examples: Leon The Professional, Inception, Inception 2010. Including the release year is recommended when multiple titles have similar names.

Output
   
Samples
     
Test

https://new.tv-api.com/api/Search-Title
Search Movie

Search for movies by title, or title name with release year. This endpoint is optimized for movie searches and provides more accurate results compared to the general title search endpoint.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find movies. You can search by movie title, keywords, or include the release year to improve accuracy. Examples: Inception, Leon The Professional, Inception 2010.

Output
   
Samples
     
Test

https://new.tv-api.com/api/Search-Movie
Search TVSeries

Search for TV series by title, or title name with release year. This endpoint is optimized for TV series searches and provides more accurate results compared to the general title search endpoint.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find TV series. You can search by series title, keywords, or include the release year to improve accuracy. Examples: Lost, Fringe, The Leftovers 2014.

Output
   
Samples
     
Test

https://new.tv-api.com/api/Search-TVSeries
Search Name

Search for people including actors, actresses, directors, writers, and other industry professionals. This endpoint allows you to find people by name.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find people. You can search by a person's full name or partial name. Examples: Jean Reno, Mel Gibson, Natalie Portman.

Output
   
Samples
     
Test

https://new.tv-api.com/api/Search-Name
Search TVEpisode

Search for TV episodes by episode title, keywords, or other episode-related information. This endpoint allows you to find individual episodes from TV series.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find TV episodes. You can search by episode title, keywords, or other related terms. Examples: london, west, gun.

Output
     
Samples
     
Test

https://new.tv-api.com/api/Search-TVEpisode
Search Company

Search for production companies, studios, and other entertainment-related companies. This endpoint allows you to find companies by name.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find companies. You can search by company name or partial name. Examples: Warner Bros, Disney, ABC Studios.

Output
 
Samples
     
Test

https://new.tv-api.com/api/Search-Company
Search Keyword

Search for keywords used to categorize movies, TV series, and episodes. This endpoint allows you to find available keywords by name.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find keywords. You can search by keyword name or related terms. Examples: gun, battle, love.

Output
 
Samples
     
Test

https://new.tv-api.com/api/Search-Keyword
Search All

Search across all available items including movies, TV series, TV episodes, people, companies, keywords, and other supported data types. This endpoint is useful when you do not know the exact item type you are looking for.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
expressionRequiredThe search expression used to find items across all supported data types. You can search by title, name, company, keyword, or other related terms. Examples: Inception, Leon, Lost.

Output
       
Samples
     
Test

https://new.tv-api.com/api/Search-All

 Titles

Title

Get detailed information about a movie or TV series using its IMDb ID. The response includes basic title information, ratings, images, posters, trailers, actors, cast, and other available metadata based on selected options.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
langOptionalLanguage of the response. Default value is en (English). Some fields will be returned in the selected language.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666
optionsOptionalOptions to include additional information in the response. You can select extra data sections such as FullActor, FullCast, Posters, Images, Trailer, Ratings, and Wikipedia. Multiple options can be selected to customize the returned data.

Output
                                     
Samples
     
Test

https://new.tv-api.com/api/Title
FullCast

Get the complete cast and crew information for a movie or TV series using its IMDb ID. This endpoint provides detailed information about actors, directors, writers, and other crew members associated with the title.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
     
Samples
     
Test

https://new.tv-api.com/api/FullCast
Posters

Get available posters for a movie or TV series using its IMDb ID. This endpoint returns poster images and related information for the requested title.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
 
Samples
     
Test

https://new.tv-api.com/api/Posters
Images

Get available images for a movie or TV series using its IMDb ID. This endpoint returns image collections and related information for the requested title.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb identifier. The ID can be a title ID starting with tt or a person ID starting with nm. Examples: tt1375666, nm0000154

Output
 
Samples
     
Test

https://new.tv-api.com/api/Images
Trailer

Get trailer information for a movie or TV series using its IMDb ID. This endpoint returns available trailer videos and related metadata for the requested title.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
Samples
     
Test

https://new.tv-api.com/api/Trailer
Ratings

Get rating information for a movie or TV series using its IMDb ID. This endpoint returns available ratings from IMDb and other supported rating sources.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
Samples
     
Test

https://new.tv-api.com/api/Ratings
User Ratings

Get user rating information for a movie or TV series using its IMDb ID. This endpoint provides rating distribution data based on user votes, including the number of votes for each rating level.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
 
Samples
     
Test

https://new.tv-api.com/api/User-Ratings
Season Episodes

Get all episodes of a specific season for a TV series using its IMDb ID. This endpoint returns episode information including episode titles, numbers, release dates, ratings, and other available details.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID of the TV series. The ID must be a valid IMDb identifier starting with tt. Example: tt0411008
seasonNumberRequiredThe season number to retrieve episodes from. Example: 1

Output
 
Samples
     
Test

https://new.tv-api.com/api/Season-Episodes
External Sites

Get external website links related to a movie, TV series, or person using its IMDb ID. This endpoint returns available links to external platforms and official pages associated with the requested item.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
   
Samples
     
Test

https://new.tv-api.com/api/External-Sites
Wikipedia

Get Wikipedia information for a movie, or TV seriesusing its IMDb ID. This endpoint returns available Wikipedia details including summaries and related information in the selected language.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
langOptionalLanguage of the response. Default value is en (English).
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
 
Samples
     
Test

https://new.tv-api.com/api/Wikipedia
IMDb List

Get IMDb lists by list identifier. This endpoint returns titles and related information from predefined IMDb lists such as popular movies, top rated titles, trending items, and other available collections.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb list identifier. The ID must be a valid IMDb list ID starting with ls. Example: ls123456789

Output
 
Samples
     
Test

https://new.tv-api.com/api/IMDb-List
Metacritic Reviews

Get Metacritic reviews for a movie or TV series using its IMDb ID. This endpoint returns available critic reviews, scores, and related review information from Metacritic.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb movie ID. This service only supports movies. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
 
Samples
     
Test

https://new.tv-api.com/api/Metacritic-Reviews
FAQ

Get frequently asked questions and answers related to the API. This endpoint provides FAQ information and allows searching through available questions and answers.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
 
Samples
     
Test

https://new.tv-api.com/api/FAQ
Awards

Get awards information for a movie or TV series using its IMDb ID. This endpoint returns available awards, nominations, wins, and related recognition details for the requested title.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
   
Samples
     
Test

https://new.tv-api.com/api/Awards
Releases

Get release information for a movie using its IMDb ID. This endpoint returns available release dates, countries, release types, and other related release details.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
   
Samples
     
Test

https://new.tv-api.com/api/Releases

 Others

Top 250 Movies

Get the top 250 movies ranked by IMDb users. This endpoint returns a list of the highest-rated movies with related information such as title details, ratings, and rankings.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
   
Samples
 
Test

https://new.tv-api.com/api/Top-250-Movies
Top 250 TVs

Get the top 250 TV series ranked by IMDb users. This endpoint returns a list of the highest-rated TV series with related information such as title details, ratings, and rankings.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
   
Samples
 
Test

https://new.tv-api.com/api/Top-250-TVs
In Theaters

Get movies currently available in theaters. This endpoint returns a list of movies that are currently playing in cinemas with related information such as title details, release information, ratings, and other available metadata.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
   
Samples
 
Test

https://new.tv-api.com/api/In-Theaters
Upcoming Movies

Get upcoming movies that are scheduled for release. This endpoint returns a list of future movie releases with related information such as title details, release dates, ratings, and other available metadata.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
     
Samples
 
Test

https://new.tv-api.com/api/Upcoming-Movies
Upcoming TVSeries

Get upcoming TV series that are scheduled for release. This endpoint returns a list of future TV series releases with related information such as title details, release dates, ratings, and other available metadata.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
     
Samples
 
Test

https://new.tv-api.com/api/Upcoming-TVSeries
Upcoming TVEpisodes

Get upcoming TV episodes that are scheduled for release. This endpoint returns a list of future TV episodes with related information such as episode details, release dates, ratings, and associated TV series information.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
     
Samples
 
Test

https://new.tv-api.com/api/Upcoming-TVEpisodes
Box Office

Get weekend box office results. This endpoint returns movie box office performance data including rankings, earnings, and related movie information.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
 
Samples
 
Test

https://new.tv-api.com/api/Box-Office
Box Office All Time

Get all-time box office results. This endpoint returns the highest-grossing movies of all time with related information such as rankings, worldwide earnings, and movie details.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
 
Samples
 
Test

https://new.tv-api.com/api/Box-Office-All-Time
Name

Get detailed information about people in the entertainment industry such as actors, actresses, directors, writers, and other professionals using their IMDb ID. This endpoint returns available personal details and related information.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb person ID. The ID must be a valid IMDb identifier starting with nm. Example: nm0000154

Output
     
Samples
     
Test

https://new.tv-api.com/api/Name
Name Awards

Get awards information for a person using their IMDb ID. This endpoint returns available awards, nominations, wins, and related recognition details for actors, actresses, directors, writers, and other professionals.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb person ID. The ID must be a valid IMDb identifier starting with nm. Example: nm0000154

Output
   
Samples
     
Test

https://new.tv-api.com/api/Name-Awards
Company

Get detailed information about a company and its associated movies. This endpoint returns company details along with related titles produced, distributed, or associated with the company.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb company ID. The ID must be a valid IMDb company identifier. Example: co0002663

Output
 
Samples
     
Test

https://new.tv-api.com/api/Company
Keyword

Get movies and TV series associated with a specific keyword. This endpoint returns titles related to the requested keyword with available information such as title details, ratings, and other metadata.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredA valid keyword used to search for related movies and TV series. Example: gun

Output
 
Samples
     
Test

https://new.tv-api.com/api/Keyword
YouTube Trailer

Get the YouTube trailer URL of a movie or TV series using its IMDb ID. This endpoint returns the available trailer link from YouTube for the requested title.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
idRequiredIMDb title ID. The ID must be a valid IMDb identifier starting with tt. Example: tt1375666

Output
Samples
     
Test

https://new.tv-api.com/api/YouTube-Trailer

 Tools

Usage

View API usage statistics. This endpoint returns the number of daily requests made to the available services.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.

Output
Samples
 
Test

https://new.tv-api.com/api/Usage
Resize Image

Resize and optimize images using the provided image URL. This endpoint allows changing image dimensions while maintaining the original image quality and returns the resized image URL.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
sizeRequiredSize of the image in Width x Height format. Examples: 8x11, 16x22, 32x44, 64x88
urlRequiredThe image URL that you want to resize. The URL must point to a valid image file.

Samples
     
Test

https://new.tv-api.com/api/Resize-Image
Resize Poster

Resize and optimize poster images using the provided poster URL. This endpoint allows changing poster dimensions based on supported sizes while maintaining image quality and returns the resized poster image URL.

Parameters
NameRequiredComment
apikeyRequiredYour API Key. This parameter is required for authentication and must be included in every request.
sizeRequiredSize of the poster image.
Supported sizes are available in two formats:
  • Wide (6:9 or 9:6): original, w45, w92, w154, w185, w200, w300, w342, w400, w500, w780, w1280
  • Square (1:1): s32, s45, s50, s64, s66, s90, s100, s115, s128, s132, s150, s180, s230, s235, s264, s300, s375, s470
urlRequiredURL of the poster image obtained from the posters service.

Samples
         
Test

https://new.tv-api.com/api/Resize-Poster