Authentication

You'll need to authenticate your requests to access any of the endpoints in the Streaming Availability API. In this guide, we'll look at how authentication works.

To authenticate your requests, you need to include a valid API key in the HTTP headers.

You can get your API key through our Developers Platform easily and get started with our free plan without giving out any payment information.

As an alternative to our own platform, Streaming Availability API is also available through the 3rd party API marketplace RapidAPI. However, please note that due to extra fees applied by RapidAPI, our prices there are accordingly higher.

If you get your API key via our Developers Platform, then you need to use https://api.movieofthenight.com/v4 as the base url, and pass the API key under the X-API-Key HTTP header.

If you get your API key via RapidAPI, then you need to use https://streaming-availability.p.rapidapi.com as the base url, and pass the API key under the X-Rapid-API-Key HTTP header.

If you are using one of the official client libraries, then simply passing the API key to the client library is enough. The client library will automatically detect the source of the API key and handle the authentication out-of-the-box.

Apart from the base url and the HTTP header for API key, rest of the functionality is the same whether you got your API key from our Developers Platform or RapidAPI.

Here is a sample request showcasing how to handle authentication depending on your setup.

# If you got your API key from https://developers.movieofthenight.com/
curl -G https://api.movieofthenight.com/v4/shows/tt0068646 \
	-H "X-API-Key: {YOUR_API_KEY}"

# If you got your API key from https://rapidapi.com/
curl -G https://streaming-availability.p.rapidapi.com/shows/tt0068646 \
	-H "X-RapidAPI-Key: {YOUR_API_KEY}"

Below, you will find more detailed instructions to how to get your API key from either our Developers Platform or RapidAPI. You only need to get one API key from one of them, you don't need to sign up on both platforms.

Developers Platform

To get your API key through our Developers Platform, simply sign up by visiting our home page here.

Once you create your account, your API key will be immediately available on the dashboard:

Image showing the location of API key on the Developers Platform Dashboard

Simply click on the "Copy" button to copy your API key, and you're good to go!

Now you can send your requests to https://api.movieofthenight.com/v4 and pass your API key under the X-API-Key HTTP header.

When you need more quota, you can simple upgrade to a paid plan later.

RapidAPI

If you'd like to use the API via RapidAPI, first you need a RapidAPI account.

If you don't have one yet, you can do so by visiting the RapidAPI's Sign Up Page.

Once you create your account, you can subscribe to the Streaming Availability API by visiting the Streaming Availability API's Pricing Page on RapidAPI.

Simply choose the plan that fits your needs and click the "Subscribe" button.

Once you subscribe to the API, you can get your API key by visiting the Streaming Availability API's Page.

Image showing the location of API key on the Streaming Availability API's RapidAPI page

Or you can visit the RapidAPI's Developer Dashboard Page and click on the "Authorization" tab.

Image showing the location of API key on the RapidAPI Developer Dashboard

You can now use this API key to authenticate your requests to the Streaming Availability API.

Note that the base url of the API and API key header are different if you get your API key via RapidAPI.

If you are using one of our official client libraries, the client library will automatically handle these for you.

If you are sending the requests manually, make sure to send your requests to https://streaming-availability.p.rapidapi.com (without /v4 suffix as your RapidAPI key is already tied to a specific version of the API) and pass your API key in the X-RapidAPI-Key HTTP header.

Was this page helpful?