streaming-availability
Advanced tools
Streaming Availability API allows getting streaming availability information of movies and series; and querying the list of available shows on streaming services such as Netflix, Disney+, Apple TV, Max and Hulu across 60 countries!
This client can be used in both JavaScript and TypeScript projects; and both in browser and Node environment.
Since using this client in browser would expose your API key to the public, it is more secure to use it in server-side applications. Using it in browser is only recommended for personal projects and development purposes.
Streaming Availability API allows getting streaming availability information of movies and series; and querying the list of available shows on streaming services such as Netflix, Disney+, Apple TV, Max and Hulu across 60 countries!
To get an instant free subscription to start using the API, you can visit the RapidAPI page of the API.
With a free subscription, you can send 100 requests per day. To send more requests, you can upgrade to paid plans whenever you like.
npm i streaming-availability
Requires Node version
18.0.0or higher.
<script src="https://cdn.jsdelivr.net/gh/movieofthenight/ts-streaming-availability@v4.4.0/bundle.min.js"></script>
This script creates a global variable at window.streamingAvailability
where you can access to the module.
import * as streamingAvailability from "streaming-availability";
const RAPID_API_KEY = "<YOUR_RAPID_API_KEY>";
const client = new streamingAvailability.Client(new streamingAvailability.Configuration({
apiKey: RAPID_API_KEY
}));
// Start using the client
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Example</title>
</head>
<body style="white-space: pre-line">
<script src="https://cdn.jsdelivr.net/gh/movieofthenight/ts-streaming-availability@v4.4.0/bundle.min.js"></script>
<script type="module">
const RAPID_API_KEY = "<YOUR_RAPID_API_KEY>";
const client = new streamingAvailability.Client(new streamingAvailability.Configuration({
apiKey: RAPID_API_KEY
}));
// Start using the client
</script>
</body>
</html>
These examples assume that you are running inside a module, since it uses top level await.
In examples folder, you can find sample package setups that you can take as a reference.
import * as streamingAvailability from "streaming-availability";
const RAPID_API_KEY = "<YOUR_RAPID_API_KEY>";
const client = new streamingAvailability.Client(new streamingAvailability.Configuration({
apiKey: RAPID_API_KEY
}));
let show = await client.showsApi.getShow(
{id: "tt0068646", country: "us"}
);
console.log(show.title);
console.log(show.overview);
show.streamingOptions["us"].forEach((streamingOption) => {
console.log(streamingOption.link);
});
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>The Godfather</title>
</head>
<body style="white-space: pre-line">
<script src="https://cdn.jsdelivr.net/gh/movieofthenight/ts-streaming-availability@v4.4.0/bundle.min.js"></script>
<script type="module">
const RAPID_API_KEY = "<YOUR_RAPID_API_KEY>";
const client = new streamingAvailability.Client(new streamingAvailability.Configuration({
apiKey: RAPID_API_KEY
}));
let show = await client.showsApi.getShow(
{id: "tt0068646", country: "us"}
);
document.body.textContent = show.title + "\r\n";
document.body.textContent += show.overview + "\r\n";
show.streamingOptions["us"].forEach((streamingOption) => {
document.body.textContent += streamingOption.link + "\r\n";
});
</script>
</body>
</html>
Checkout examples folder for the rest of the examples.
This client supports auto-pagination for the paginated endpoints.
If you'd like to use auto-pagination, you can call the corresponding auto pagination versions of the functions.
An example call without auto pagination:
const searchResult = await client.showsApi.searchShowsByFilters(({
country: "us",
catalogs: ["netflix"],
genres: ["action"],
showType: streamingAvailability.ShowType.Movie,
orderBy: "popularity_1year",
}));
An example call with auto pagination that fetches at most 3 pages:
const shows = client.showsApi.searchShowsByFiltersWithAutoPagination({
country: "us",
catalogs: ["netflix"],
genres: ["action"],
showType: streamingAvailability.ShowType.Movie,
orderBy: "popularity_1year",
}, 3)
Then you can iterate over the results in the following way:
for await (const show of shows) {
// Do something with the show
}
While the client libraries have MIT licenses, the Streaming Availability API itself has further Terms & Conditions. Make sure to read it before using the API.
Notably, the API requires an attribution to itself, if the data acquired through is made public. You can read further about the attribution requirement on the Terms & Conditions page.
If you have any questions or need further assistance, please don't hesitate to reach us via our contact form.
How often the data is updated?
I run into an issue. How can I get help?
API returned me some wrong data. What can I do?
I have a request to get a new streaming service supported by the API.
I need a client library in another language.
What is RapidAPI?
| Service Id | Service Name | Supported Countries |
|---|---|---|
netflix | Netflix | 59 Countries |
prime | Prime Video | 56 Countries |
disney | Disney+ | 46 Countries |
hbo | Max | 28 Countries |
hulu | Hulu | United States |
peacock | Peacock | United States |
paramount | Paramount+ | 18 Countries |
starz | Starz | United States |
apple | Apple TV | 52 Countries |
mubi | Mubi | 53 Countries |
stan | Stan | Australia |
now | Now | United Kingdom, Ireland, Italy |
crave | Crave | Canada |
all4 | Channel 4 | United Kingdom, Ireland |
iplayer | BBC iPlayer | United Kingdom |
britbox | BritBox | United States, Canada, Australia, South Africa |
hotstar | Hotstar | India, Canada, United Kingdom, Singapore |
zee5 | Zee5 | 58 Countries |
curiosity | Curiosity Stream | 57 Countries |
wow | Wow | Germany |
discovery | Discovery+ | United States, Canada, Ireland, Italy, United Kingdom, Germany, Austria |
sonyliv | SonyLiv | India |
itvx | ITVX | United Kingdom |
plutotv | Pluto TV | 25 Countries |
tubi | Tubi | Australia, Canada, New Zealand, Ecuador, Mexico, Panama, United States |
blutv | BluTV | Turkey, Germany, Azerbaijan |
| Country Code | Country Name |
|---|---|
ae | United Emirates |
ar | Argentina |
at | Austria |
au | Australia |
az | Azerbaijan |
be | Belgium |
bg | Bulgaria |
br | Brazil |
ca | Canada |
ch | Switzerland |
cl | Chile |
co | Colombia |
cy | Cyprus |
cz | Czech Republic |
de | Germany |
dk | Denmark |
ec | Ecuador |
ee | Estonia |
es | Spain |
fi | Finland |
fr | France |
gb | United Kingdom |
gr | Greece |
hk | Hong Kong |
hr | Croatia |
hu | Hungary |
id | Indonesia |
ie | Ireland |
il | Israel |
in | India |
is | Iceland |
it | Italy |
jp | Japan |
kr | South Korea |
lt | Lithuania |
md | Moldova |
mk | North Macedonia |
mx | Mexico |
my | Malaysia |
nl | Netherlands |
no | Norway |
nz | New Zealand |
pa | Panama |
pe | Peru |
ph | Philippines |
pl | Poland |
pt | Portugal |
ro | Romania |
rs | Serbia |
ru | Russia |
se | Sweden |
sg | Singapore |
si | Slovenia |
sk | Slovakia |
th | Thailand |
tr | Turkey |
ua | Ukraine |
us | United States |
vn | Vietnam |
za | South Africa |
FAQs
Streaming Availability API allows getting streaming availability information of movies and series; and querying the list of available shows on streaming services such as Netflix, Disney+, Apple TV, Max and Hulu across 60 countries!
The npm package streaming-availability receives a total of 207 weekly downloads. As such, streaming-availability popularity was classified as not popular.
We found that streaming-availability demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 0 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
In this segment of the Risky Business podcast, Feross Aboukhadijeh and Patrick Gray discuss the challenges of tracking malware discovered in open source softare.
Research
Security News
A threat actor's playbook for exploiting the npm ecosystem was exposed on the dark web, detailing how to build a blockchain-powered botnet.
Security News
NVD’s backlog surpasses 20,000 CVEs as analysis slows and NIST announces new system updates to address ongoing delays.