Postman REST API Client: Getting Started

REST technology is generally preferred to the more robust Simple Object Access Protocol (SOAP) technology because REST leverages less bandwidth, making it more suitable for internet usage.

REST APIs are all around us these days. Almost every major service provider on the internet  provides some kind of REST API. There are so many REST clients available that can be used to interact with these APIs and test requests before writing your code. Postman, is one of the world’s leading API Development Environment (ADE) with so many features baked in.

In this tutorial, you are going to learn how to use Postman to make API calls with and without authorization.

Postman Setup

The only thing you need  to do before starting this tutorial is to download and install Postman. Get it from here. Installation should be straightforward across different platforms.

API Calls (No Authorization)

The first thing you are going to do is to make an API call which does not require authorization. Launch Postman and close the welcome dialog.

 

Example #1:

You are going to fetch the exchange rate between two currencies (USD, GBP) from ExchangeRatesApi.

1- Enter https://api.exchangeratesapi.io/latest?symbols=USD,GBP into the URL bar at the top.

2- In the drop down to the left, make sure the method type selected is GET.

3- Finally, press Send.

You should end up with a response in the textarea below.

Postman provides you with some really useful data about the request you just made. First of all, to the far right, you get to see the status code of the response and the size of data returned. You also get to see how long the request took.

To the left, you get to see even more details. By clicking through the tabs, you can view extra information about the response such as the cookies and headers returned. Below that you can select the different display formats of the data returned.

 

Example #2:

Now you are going to make another GET request. This time however, you are going to get all  exchange rates with the USD as the base currency. Click the + icon at the top to open a new tab.

 

Enter https://api.exchangeratesapi.io/latest?base=USD into the URL field and click Send.

You should end up with a response containing the exchange rates of all the currencies in relation to the USD.

API Calls (With Authorization in Query Params)

Now you are going to learn  how to make requests to APIs which require authorization. In the current example, authorization is achieved through adding one or more parameters to the API URL, namely after a question mark. So let’s see this.

For this example, you will be using the Fixer.io currency exchange API for demonstration.

1- Head over to fixer.io and click Get Free API Key.

2- Click Get Free API Key and you will be redirected to a sign up page. Fill in your details and click Sign up at the bottom.

3- Once you sign up successfully, you will be redirected to your dashboard. You will now be able to see your API key.

4- Before you make a request using your API key, try making a request without it. Open a new tab in Postman, enter http://data.fixer.io/api/latest and press Send. You should end up with the following response.

5- Now add ?access_key=YOUR_API_KEY to the end of the URL and press Send.

You should end up with a response similar to the following.

API Calls (With Authorization in Headers)

You have now learnt to authorize requests by passing the access token as a query parameter. In this example, you are going to learn how to use request headers to pass access tokens.

For this example, you will be using the Github API for demonstration.

1- Head over to Github and create a personal access token. You will need to login or create an account if you do not have one.

Once you have successfully created your token, you will need to copy and save it somewhere. Note. Once your close the tokens page, your newly created token will be hidden, never to be seen again.

2- Now head over to Postman and open a new tab. Paste https://api.github.com into the URL field.

3- Select the Headers tab and fill in the details as follows.

4- Once you hit Send, you should get the following details.

 

One thing to remember is that different APIs offer different methods of authorization. You will be happy to hear that Postman supports most if not all of them.

This is just the tip of the iceberg. Postman supports so many features. Feel free to check out the documentation for more details.

 

 

Twitter API: Extracting Tweets with Specific Phrase

Twitter has been a good source for Data Mining. Many data scientists and analytics companies collect tweets and analyse them to understand people’s opinion about some matters.

In this tutorial, you will learn how to use Twitter API and Python Tweepy library to search for a word or phrase and extract tweets that include it and print the results.

Continue reading “Twitter API: Extracting Tweets with Specific Phrase”

Searching GitHub Using Python & GitHub API

GitHub is a web-based hosting service for version control using Git. It is mostly used for storing and sharing computer source code. It offers all of the distributed version control and source code management functionality of Git as well as adding its own features.

GitHub stores more than 3 million repositories with more than 1.7 million developers using it daily. With so much data, it can be quite daunting at first to find information one needs or do repetitive tasks, and that is when GitHub API comes handy.

In this tutorial, you are going to learn how to use GitHub API to search for repositories and files that much particular keywords(s) and retrieve their URLs using Python. You will learn also how to download files or a specific folder from a GitHub repository.

Continue reading “Searching GitHub Using Python & GitHub API”

Amazon S3 with Python Boto3 Library

Amazon S3 is the Simple Storage Service provided by Amazon Web Services (AWS) for object based file storage. With the increase of Big Data Applications and cloud computing, it is absolutely necessary that all the “big data” shall be stored on the cloud for easy processing over the cloud applications.

In this tutorial, you will learn how to use Amazon S3 service via the Python library Boto3. You will learn how to create S3 Buckets and Folders, and how to upload and access files to and from S3 buckets. Eventually, you will have a Python code that you can run on EC2 instance and access your data on the cloud while it is stored on the cloud.

Continue reading “Amazon S3 with Python Boto3 Library”

Extracting YouTube Comments with YouTube API & Python

YouTube is the world’s largest video-sharing site with about 1.9 billion monthly active users. People use it to share info, teach, entertain, advertise and much more.

So YouTube has so much data that one can utilize to carry out research and analysis. For example, extracting YouTube video comments can be useful to run Sentiment Analysis and other Natural Language Processing tasks. YouTube API enables you to search for videos matching specific search criteria.

In this tutorial, you will learn how to extract comments from YouTube videos and store them in a CSV file using Python. It will cover setting up a project on Google console, enabling the necessary YouTube API and finally writing the script that interacts with the YouTube API.

Continue reading “Extracting YouTube Comments with YouTube API & Python”

Google Places API: Extracting Location Data & Reviews

Google places API allows developers to access a wealth of information from Google’s database for over 100 million places including location data, contact information, user ratings and reviews and more.

In this tutorial, you will learn how to create a reusable class to read and extract location related information from Google Places API. This tutorial will help you if you want to extract business’s name, address, phone number, website, and reviews.

Continue reading “Google Places API: Extracting Location Data & Reviews”

AWS EC2 Management with Python Boto3 – Create, Monitor & Delete EC2 Instances

Amazon Web Services is one of the world’s leading cloud service provider. among many services, Elastic Compute Cloud (EC2) allows users to rent virtual computers over the AWS.

In this tutorial, you will learn how to monitor, create and manage EC2 instances using Python. AWS has launched the Python library called Boto 3, which is a Python SDK for AWS resources. This tutorial will cover how to install, configure and get started with Boto3 library for your AWS account. This tutorial will also cover how to start, stop, monitor, create and terminate Amazon EC2 instances using Python programs.

Finally, the tutorial provides Python code to easily see EC2 instances and key information in tabular format and ways to query EC2 instances for dynamic access and monitoring.

Continue reading “AWS EC2 Management with Python Boto3 – Create, Monitor & Delete EC2 Instances”

Yelp Fusion API tutorial

Yelp Fusion API is a REST API that gives access to information across 50 million businesses across countries.

In this tutorial, you will be learning how to use the Yelp API to search businesses by providing their names, locations or phone numbers. You will also learn to match businesses in a given location to check their availability. You will be using the requests library of Python, Requests and JSON library to parse the JSON response of data.

This tutorial covers the following features of the Yelp API: Business Search, Reviews Search, Phone Search, and Business Match.

Finally, there will be a practical project to help you use Yelp API in a real-life case.

Continue reading “Yelp Fusion API tutorial”