About the API:

The IMDB Charts API is a robust tool that grants developers access to an extensive collection of charts showcasing the most popular movies and TV shows on IMDB. With this API, you can effortlessly retrieve valuable information such as titles, ranks, ratings, votes, covers, and more.

By leveraging the IMDB Charts API, you can integrate the power of IMDB's comprehensive database directly into your applications, websites, or services. Whether you're building a movie recommendation platform, creating a media-focused website, or developing a movie discovery app, this API provides a reliable and efficient way to access up-to-date information about the most popular content.

With the ability to retrieve detailed chart data, you can offer your users valuable insights into the current trends and top-ranking titles on IMDB. Users can explore the most highly-rated movies and TV shows, discover hidden gems, and stay up-to-date with the latest releases.

The IMDB Charts API is designed for speed and reliability, ensuring that you receive the requested data quickly and consistently. This allows you to provide seamless user experiences without compromising performance. Whether you need to display top-rated movies on your homepage or showcase trending TV shows on a dedicated page, the API delivers the necessary data efficiently.

In addition to titles, ranks, ratings, and votes, the API also provides access to covers, allowing you to display visually appealing thumbnails or posters alongside the relevant information. This enhances the overall user experience and helps engage users with enticing visuals.

Developers can easily integrate the IMDB Charts API into their projects using the available endpoints and straightforward API documentation. The API responds with well-structured data, making it simple to parse and display the information in the desired format.

The IMDB Charts API is an essential tool for developers looking to enrich their applications or websites with up-to-date information on popular movies and TV shows. With its speed, reliability, and comprehensive data, this API empowers you to create engaging user experiences and provide valuable insights into the world of entertainment. Stay connected to the pulse of the movie and TV industry with the IMDB Charts API.

 

What your API receives and what your API provides (input/output)?

Get an IMDB Chart by ID

The API endpoint expects an id query parameter and the JSON response format is different based on it. We currently support these chart ids:

• boxoffice: Top Box Office (US)
• moviemeter: Most Popular Movies
• top: IMDb Top 250 Movies
• top-english-movies: Top Rated English Movies
• tvmeter: Most Popular TV Shows
• toptv: Top Rated TV Shows
• top-rated-indian-movies: Top Rated Indian Movies
• bottom: Lowest Rated Movies
• top-action: (Top Rated Action Movies
• top-adventure: Top Rated Adventure Movies
• top-animation: Top Rated Animation Movies
• top-biography: Top Rated Biography Movies
• top-comedy: Top Rated Comedy Movies
• top-crime: Top Rated Crime Movies
• top-drama: Top Rated Drama Movies
• top-family: Top Rated Family Movies
• top-fantasy: Top Rated Fantasy Movies
• top-film_noir: Top Rated Film-Noir Movies
• top-history: Top Rated History Movies
• top-horror: Top Rated Horror Movies
• top-music: Top Rated Music Movies
• top-musical: Top Rated Musical Movies
• top-mystery: Top Rated Mystery Movies
• top-romance: Top Rated Romance Movies
• top-sci_fi: Top Rated Sci-Fi Movies
• top-sport: Top Rated Sport Movies
• top-thriller: Top Rated Thriller Movies
• top-war: Top Rated War Movies
• top-western: Top Rated Western Movies

 

What are the most common uses cases of this API?

1. Movie and TV Show Recommendations: Streaming platforms, movie discovery apps, and entertainment websites can utilize the IMDB Charts API to provide personalized movie and TV show recommendations to their users. By analyzing the most popular titles, ratings, and votes, the API can suggest content that aligns with users' preferences and viewing habits.

2. Content Curation: Content curators or editors can leverage the IMDB Charts API to create curated lists of popular movies and TV shows. They can highlight trending titles, highly rated films, or critically acclaimed series, helping users discover new content and stay informed about the latest trends in the entertainment industry.

3. Research and Analysis: Researchers and analysts interested in studying trends in the movie and TV industry can utilize the IMDB Charts API as a valuable data source. They can extract information about top-ranked movies, analyze ratings and votes over time, and gain insights into audience preferences and viewing habits.

4. Marketing and Promotion: Marketers and advertisers can utilize the IMDB Charts API to identify popular movies and TV shows to align their campaigns with. By targeting advertisements or promotions around highly rated or trending content, they can effectively reach their target audience and maximize engagement.

5. Content Aggregation: Websites or apps that aggregate content from multiple sources can integrate the IMDB Charts API to provide users with an overview of the most popular and highly-rated movies and TV shows across different platforms. This allows users to stay updated with the latest trends and make informed decisions about what to watch.

6. Recommendation Engines: Recommendation engines for movie and TV show platforms can incorporate the IMDB Charts API to enhance their recommendation algorithms. By considering the rankings, ratings, and votes of popular titles, the API can improve the accuracy and relevance of the recommendations, leading to a more satisfying user experience.

7. User-generated Content Platforms: User-generated content platforms, such as forums or social media communities focused on movies and TV shows, can utilize the IMDB Charts API to generate discussions and debates around the most popular titles. By featuring the charts or using the data to spark conversations, these platforms can engage their users and foster an active and passionate community.

These use cases demonstrate the versatility and value of the IMDB Charts API in various applications, from personalizing recommendations to conducting industry research. By harnessing the rich data provided by the API, developers, and businesses can enhance their platforms, engage users, and gain insights into the dynamic world of movies and TV shows.

 

Are there any limitations to your plans?

Besides the number of API calls, there are no other limitations.

                                                                            
GET https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts
                                                                            
                                                                        

       
                                                                                                        
                                                                                                                                                                                                                            {"results":[{"rank":1,"url":"https://www.imdb.com/title/tt6791350?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_1","img":"https://m.media-amazon.com/images/M/MV5BMDgxOTdjMzYtZGQxMS00ZTAzLWI4Y2UtMTQzN2VlYjYyZWRiXkEyXkFqcGdeQXVyMTkxNjUyNQ@@._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"James Gunn (dir.), Chris Pratt, Chukwudi Iwuji","title":"Guardians of the Galaxy Vol. 3","gross":"$213.2M","weekend":"$60.5M","weeks":2},{"rank":2,"url":"https://www.imdb.com/title/tt6718170?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_2","img":"https://m.media-amazon.com/images/M/MV5BOTJhNzlmNzctNTU5Yy00N2YwLThhMjQtZDM0YjEzN2Y0ZjNhXkEyXkFqcGdeQXVyMTEwMTQ4MzU5._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"Aaron Horvath (dir.), Chris Pratt, Anya Taylor-Joy","title":"The Super Mario Bros. Movie","gross":"$536.0M","weekend":"$13.0M","weeks":6},{"rank":3,"url":"https://www.imdb.com/title/tt20768712?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_3","img":"https://m.media-amazon.com/images/M/MV5BNGM0ZmFiYmEtMzMxOC00YWFlLWE4YzQtYzk2Y2NjNzZjYzA1XkEyXkFqcGdeQXVyMTQzNTA5MzYz._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"Bill Holderman (dir.), Diane Keaton, Jane Fonda","title":"Book Club: The Next Chapter","gross":"$6.5M","weekend":"$6.5M","weeks":1},{"rank":4,"url":"https://www.imdb.com/title/tt13345606?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_4","img":"https://m.media-amazon.com/images/M/MV5BMmZiN2VmMjktZDE5OC00ZWRmLWFlMmEtYWViMTY4NjM3ZmNkXkEyXkFqcGdeQXVyMTI2MTc2ODM3._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"Lee Cronin (dir.), Mirabai Pease, Richard Crouchley","title":"Evil Dead Rise","gross":"$60.2M","weekend":"$3.7M","weeks":4},{"rank":5,"url":"https://www.imdb.com/title/tt9185206?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_5","img":"https://m.media-amazon.com/images/M/MV5BNTBhNmM2ODgtNDI4My00MWM5LWIzYmYtYzQzNWViNzg5MmVlXkEyXkFqcGdeQXVyOTIxNTAyMzU@._V1_UX45_CR0,0,45,67_AL_.jpg","crew":"Kelly Fremon Craig (dir.), Abby Ryder Fortson, Rachel McAdams","title":"Are You There God? It's Me, Margaret.","gross":"$16.5M","weekend":"$2.5M","weeks":3},{"rank":6,"url":"https://www.imdb.com/title/tt8080204?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_6","img":"https://m.media-amazon.com/images/M/MV5BNmNmNWNiMjUtZmYyMC00OWVhLThmMTItNjkxYzU4Yzk2NTdlXkEyXkFqcGdeQXVyMDc5ODIzMw@@._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"Robert Rodriguez (dir.), Ben Affleck, Alice Braga","title":"Hypnotic","gross":"$2.4M","weekend":"$2.4M","weeks":1},{"rank":7,"url":"https://www.imdb.com/title/tt10366206?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_7","img":"https://m.media-amazon.com/images/M/MV5BMDExZGMyOTMtMDgyYi00NGIwLWJhMTEtOTdkZGFjNmZiMTEwXkEyXkFqcGdeQXVyMjM4NTM5NDY@._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"Chad Stahelski (dir.), Keanu Reeves, Laurence Fishburne","title":"John Wick: Chapter 4","gross":"$183.0M","weekend":"$1.9M","weeks":8},{"rank":8,"url":"https://www.imdb.com/title/tt10276482?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_8","img":"https://m.media-amazon.com/images/M/MV5BNjQwZDIyNjAtZGQxMC00OTUwLWFiOWYtNzg2NDc5Mjc1MDQ5XkEyXkFqcGdeQXVyMTAxNzQ1NzI@._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"Jim Strouse (dir.), Priyanka Chopra Jonas, Sam Heughan","title":"Love Again","gross":"$5.0M","weekend":"$1.6M","weeks":2},{"rank":9,"url":"https://www.imdb.com/title/tt16419074?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_9","img":"https://m.media-amazon.com/images/M/MV5BYmNlOTNlYjUtM2U3Yy00M2ZjLTkxZDQtN2NiNGZiZDI0ZjE3XkEyXkFqcGdeQXVyMTUzMTg2ODkz._V1_UY67_CR0,0,45,67_AL_.jpg","crew":"Ben Affleck (dir.), Matt Damon, Jason Bateman","title":"Air","gross":"$51.6M","weekend":"$768K","weeks":6},{"rank":10,"url":"https://www.imdb.com/title/tt2906216?pf_rd_m=A2FGELUUNOQJNL&pf_rd_p=f9f31d04-fc22-4d12-86b4-f46e25aa2f6f&pf_rd_r=A4T87QC9T168KVW8REDJ&pf_rd_s=center-1&pf_rd_t=15506&pf_rd_i=boxoffice&ref_=cht_bo_10","img":"https://m.media-amazon.com/images/M/MV5BNmFkN2M2NzItOTY5YS00MmE2LTk3ZjctNTk2YzQ5ZmRiYzJjXkEyXkFqcGdeQXVyMjkwOTAyMDU@._V1_UX45_CR0,0,45,67_AL_.jpg","crew":"John Francis Daley (dir.), Chris Pine, Michelle Rodriguez","title":"Dungeons & Dragons: Honor Among Thieves","gross":"$92.2M","weekend":"$741K","weeks":7}]}
                                                                                                                                                                                                                    
                                                                                                    

curl --location --request GET 'https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice' --header 'Authorization: Bearer YOUR_API_KEY' 

    

OkHttpClient client = new OkHttpClient().newBuilder()
.build();
MediaType mediaType = MediaType.parse("text/plain");
Request request = new Request.Builder()
.url("https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice")
.method("GET", body)
.addHeader("Authorization", "YOUR_API_KEY")
.build();
Response response = client.newCall(request).execute();

var settings = {
"url": "https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice",
"method": "GET",
"timeout": 0,
"headers": {
    "Authorization": "YOUR_API_KEY"
},
};

$.ajax(settings).done(function (response) {
console.log(response);
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;
    
xhr.addEventListener("readystatechange", function() {
if(this.readyState === 4) {
    console.log(this.responseText);
    }
});
    
xhr.open("GET", "https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice");
xhr.setRequestHeader("Authorization", "Bearer YOUR_API_KEY");

var axios = require('axios');
var config = {
method: 'GET',
url: 'https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice',
headers: { 
    'Authorization': 'Bearer YOUR_API_KEY'
    },
};
axios(config).then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});

$curl = curl_init();
    
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer YOUR_API_KEY'
    ),
));
    
$response = curl_exec($curl);
    
curl_close($curl);
echo $response;

import requests
    
url = "https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice"
    
headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}
    
response = requests.request("GET", url, headers=headers, data=payload)
    
print(response.text)
    

require "uri"
require "net/http"
    
url = URI("https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice")
    
http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::GET.new(url)
request["Authorization"] = "Bearer YOUR_API_KEY"
    
response = http.request(request)
puts response.read_body

http --follow --timeout 3600 GET 'https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice' \
Authorization:'Bearer YOUR_API_KEY'

var client = new RestClient("https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice");
client.Timeout = -1;
var request = new RestRequest(Method.GET);
request.AddHeader("Authorization", "Bearer YOUR_API_KEY");
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);

package main
import (
    "fmt"
    "net/http"
    "io/ioutil"
)
func main() {
    url := "https://zylalabs.com/api/2021/imdb+charts+api/1796/get+charts?id=boxoffice"
    method := "GET"
    client := &http.Client {
    }
    req, err := http.NewRequest(method, url, nil)
    if err != nil {
    fmt.Println(err)
    return
    }
    req.Header.Add("Authorization", "Bearer YOUR_API_KEY")
    res, err := client.Do(req)
    if err != nil {
    fmt.Println(err)
    return
    }
    defer res.Body.Close()

    body, err := ioutil.ReadAll(res.Body)
    if err != nil {
    fmt.Println(err)
    return
    }
    fmt.Println(string(body))
}