\
APIs are essential when it comes to software development. It allows software to communicate with each other to exchange information. In the beginning, when learning to make API calls, it can be a challenge using tools such as cURL in the terminal, **FETCH** in the frontend or backend option such as **Express**. Postman is a great tool for understanding the process of making API calls and getting feedback on the response of those calls. It provides a visual interface and allows developers to get a sense of the workflow which can provide easier transitions to using other tools such as cURL or Express.

\
In this tutorial, we will be using [Postman](https://www.postman.com/) to make API requests to [Livepeer Video Services](https://livepeer.com/) to get a better understanding on building an application similar to Twitch or YouTube. The Livepeer Video Services API consists of the standard features for users such as creating new live streams, recording the streams and getting a list of their streams. By leveraging [Livepeer’s decentralized network](https://livepeer.org/) for transcoding, it will be easier and cost effective to scale for in the future.

**Step 1:** Get access to Postman

* Go to [Postman’s website](https://www.postman.com/) and sign up for a free account.

   ![](https://cdn.hackernoon.com/images/-va93ybm.png)
* You can use their web browser tool or download the desktop version. For this tutorial, we will use the desktop version with [Mac OS](https://www.postman.com/downloads/), but it is also available for [Windows](https://dl.pstmn.io/download/latest/win64) and [Linux](https://dl.pstmn.io/download/latest/linux64).

  \

**Step 2:** Get access to Livepeer Video Services

* Go to [Livepeer Video Services](https://livepeer.com/) and sign up for a free account.

 ![](https://cdn.hackernoon.com/images/-sua3y7u.png)

 ![](https://cdn.hackernoon.com/images/-skc3yev.png)

Now that we have access to these two services, let’s start interacting with them.

\
**Step 3:** Get anAPI key

* In your Livepeer dashboard, tap the developers tab and select API keys
* Click the button that says **Create Key**
* Then give your key a name and click **Create**

 ![](https://cdn.hackernoon.com/images/-j7d3ybr.png)

 ![](https://cdn.hackernoon.com/images/-cde3y9h.png)

With the API key, we will start going through the **Stream** section of Livepeer Video Services' [API Reference](https://livepeer.com/docs/api-reference/stream/post-stream). The reference uses the cURL command but we will do this using Postman instead.

To learn more about streaming Livepeer Video Services with the cURL command, visit the tutorial [How To Stream With Livepeer Video Service’s RTMP API](https://livepeer.com/blog/streaming-with-rtmp-api)

\
**Step 4:**

* Launch the Postman desktop app
* Click the **+** icon under the Reports tab to start a new request or select **New Tab** under the file menu

 ![](https://cdn.hackernoon.com/images/-pkg3yxn.png)

**Step 5:** Create a stream

* Select the **POST** option and the paste in Livepeer Video Services’ base URL for streaming **https://livepeer.com/api/stream**

 ![](https://cdn.hackernoon.com/images/-dvh3yeh.png)

* Then underneath the URL, click on the **Authorization** tab, and select **Bearer Token** as the type
* Copy and paste your API key from Livepeer Video Services

 ![](https://cdn.hackernoon.com/images/-o3i3y2w.png)

* Now select the **Body** tab and then underneath select the **raw** radio button
* Then click the the **Text** drop down menu and select the **JSON** option
* In the text box field below, paste the following code which is from the [Livepeer Video Services' API reference docs](https://livepeer.com/docs/api-reference/stream/post-stream). You can change the **name** to whatever you want as this is for the name of your stream

  `{ "name": "First Stream", "profiles": [ { "name": "720p", "bitrate": 2000000, "fps": 30, "width": 1280, "height": 720 }, { "name": "480p", "bitrate": 1000000, "fps": 30, "width": 854, "height": 480 }, { "name": "360p", "bitrate": 500000, "fps": 30, "width": 640, "height": 360 } ] }`

 ![](https://cdn.hackernoon.com/images/-m4j3yjg.png)

* Now click on the **Send** button and you should receive a confirmation that it went through with a 201 status
* Scroll down in the response and copy the *id* for the stream that was just created. It should be under *renditions*

 ![](https://cdn.hackernoon.com/images/-rzk3yhs.png)

* Check the Livepeer Video Services’ dashboard and the stream that you just created should come up

 ![](https://cdn.hackernoon.com/images/-rzl3y6z.png)

Now let’s get the stream we just created

\
**Step 6:** Retrieve a stream

\
* In the Postman app, we will change from **POST** to **GET**, and in the URL paste in **https://livepeer.com/api/stream/{id}** and replace **{id}** with the id we copied from our response earlier.
* Click the blue send button and you should get back a 200 status with the response including the parameters of the stream

 ![](https://cdn.hackernoon.com/images/-avm3ylx.png)

**Step 7:** Get a list of streams

* In order to get a list of streams, follow **Step 5** to create a second stream so that there is more than one stream
* Give it a name of your choice, but for this example, it will be named *Second Stream*

 ![](https://cdn.hackernoon.com/images/-h2n3yd6.png)

* Go back to Livepeer Video Services’ dashboard and you should see the **Second Stream** appear

 ![](https://cdn.hackernoon.com/images/-66o3yxs.png)

* Now that we have multiple streams, go back to the Postman app and retrieve them
* Similar to **Step 6** we are changing **POST** to **GET** and insert the base URL for retrieving multiple streams **https://livepeer.com/api/stream?streamsonly=1**
* Remember that the body should have the **none radio button** selected since we are not passing in any data
* Click the blue send button and it should confirm with a response of status **200** meaning that the request went through and a response back with a list of your streams

 ![](https://cdn.hackernoon.com//images/tmDP7ZtAqnXpU3irSFcz2Yv8m682-2022-03-21T15:34:17.337Z-cl10vc0s900090as6h4fg8039)

**Step 8:** Toggling a stream

* Replace **GET** with **Patch** and insert the URL for for toggling recording **https://livepeer.com/api/stream/{id}/record** and replace **{id}** with the one you have at the end of **Step 5**
* Now we will toggle the recording on by putting the following in body, just as we did in **Step 5**

  `{ “record”: true }`
* Click the blue send button and it should confirm with a response of status **204** meaning that the request went through

 ![](https://cdn.hackernoon.com//images/tmDP7ZtAqnXpU3irSFcz2Yv8m682-2022-03-21T15:34:17.334Z-cl10vc0s600080as644mi9qzq)

**Step 9:** Update a stream

* Select **Patch** and insert the URL for updating a stream **https://livepeer.com/api/stream/{id}** and replace **{id}** with the one you have at the end of **Step 5**
* Now we will not have the recording on and suspend the stream by putting the following in body, just as we did in **Step 5**

  { `“record”: false, “suspend”: true }`
* Click the blue send button and it should confirm with a response of status **204** meaning that the request went through

 ![](https://cdn.hackernoon.com//images/tmDP7ZtAqnXpU3irSFcz2Yv8m682-2022-03-21T15:34:17.333Z-cl10vc0s500070as62ht9a830)

**Step 10:** Delete a stream

* We will delete **Second Stream** by replacing **Patch** with **Delete** and insert the URL for deleting a stream **https://livepeer.com/api/stream/{id}** and replace the **{id}** you have at the end of **Step 5**
* Click the blue send button and you should get a status **204** as a response to confirm the stream has been deleted

 ![](https://cdn.hackernoon.com//images/tmDP7ZtAqnXpU3irSFcz2Yv8m682-2022-03-21T15:25:26.610Z-cl10v0nah00000as691kp0vaf)

* Go back to Livepeer Video Services' dashboard to confirm that the stream has been deleted

 ![](https://cdn.hackernoon.com/images/6sWrtbrOmsOIbrWzrG88lYfV4ch1-nc93q26.png)

Now that you are able to use Postman to interact with Livepeer Video Services' API, take your skills to another level using cURL. To learn more, check out the tutorial How to Stream With Livepeer Video Service’s RTMP API.

\
[How to Stream with RTMP API](https://livepeer.com/blog/streaming-with-rtmp-ap)

\
*First Published [here](https://livepeer.com/blog/how-to-make-api-calls-with-postman-and-livepeer-video-services/)*

\


Fetch

YouTube

Read My Stories

Too Long; Didn't Read

Cassandra Forward a free Cassandra-focused community event

Build a Twitch Clone with the Livepeer API

Too Long; Didn't Read

Companies Mentioned

@shihyu

RELATED STORIES