How To Parse JSON in Python

Here we will guide you through the process of importing json and using it to parse JSON in Python, with a useful JSON-Python transformation table. Whether you are an experienced Python developer or just getting started, this step-by-step tutorial you teach you how to parse JSON like a pro!
11 min read
Antonello Zanini author image
Antonello Zanini
How to parse JSON data with Python

In this tutorial, you will see:

An Introduction to JSON in Python

Before digging into JSON parsing with Python, let’s understand what JSON is and how to use it in Python.

What Is JSON?

JSON, short for JavaScript Object Notation, is a lightweight data-interchange format. It is simple for humans to read and write and easy for machines to parse and generate. This makes it one of the most popular data formats. Specifically, JSON has become the “language of the web” because it is commonly used for transmitting data between servers and web applications via APIs.

Here is an example of JSON:

  "name": "Maria Smith",
  "age": 32,
  "isMarried": true,
  "hobbies": ["reading", "jogging"],
  "address": {
    "street": "123 Main St",
    "city": "San Francisco",
    "state": "CA",
    "zip": "12345"
  "phoneNumbers": [
      "type": "home",
      "number": "555-555-1234"
      "type": "work",
      "number": "555-555-5678"
  "notes": null

As you can see, JSON consists of key-value pairs. Each key is a string and each value can be a string, number, boolean, null, array, or object. Even though it is similar to a JavaScript object, JSON can be used with any programming language, including Python.

How to Deal With JSON in Python

Python natively supports JSON through the json module, which is part of the Python Standard Library. This means that you do not need to install any additional library to work with JSON in Python. You can import json as follows:

import json

The built-in Python json library exposes a complete API to deal with JSON. In particular, it has two key functions: loads and load. The loads function allows you to parse JSON data from a string. Note that despite its name appearing to be plural, the ending “s” stands for “string.” So, it should be read as “load-s.” On the other hand, the load function is for parsing JSON data into bytes.

Through those two methods, json gives you the ability to convert JSON data to equivalent Python objects like dictionaries and lists, and vice versa. Plus, the json module allows you to create custom encoders and decoders to handle specific data types.

Keep reading and find out how to use the json library to parse JSON data in Python!

Parsing JSON Data With Python

Let’s take a look at some real-world examples and learn how to parse JSON data from different sources into different Python data structures.

Converting a JSON String to a Python Dictionary

Assume that you have some JSON data stored in a string and you want to convert it to a Python dictionary. This is what the JSON data looks like:

  "name": "iPear 23",
  "colors": ["black", "white", "red", "blue"],
  "price": 999.99,
  "inStock": true

And this is its string representation in Python:

smartphone_json = '{"name": "iPear 23", "colors": ["black", "white", "red", "blue"], "price": 999.99, "inStock": true}'

Consider using the Python triple quotes convention to store long multi-line JSON strings.

You can verify that smartphone contains a valid Python string with the line below:


This will print:

<class 'str'>

str stands for “string” and means that the smartphone variable has the text sequence type.

Parse the JSON string contained in smartphone into a Python dictionary with the json.loads() method as follows:

import json

# JSON string
smartphone_json = '{"name": "iPear 23", "colors": ["black", "white", "red", "blue"], "price": 999.99, "inStock": true}'
# from JSON string to Python dict
smartphone_dict = json.loads(smartphone_json)

# verify the type of the resulting variable
print(type(smartphone_dict)) # dict

If you run this snippet, you would get:

<class 'dict'>

Fantastic! smartphone_dict now contains a valid Python dictionary!

Thus, all you have to do to convert a JSON string to a Python dictionary is to pass a valid JSON string to json.loads()

You can now access the resulting dictionary fields as usual:

product = smartphone_dict['product'] # smartphone
priced = smartphone['price'] # 999.99
colors = smartphone['colors'] # ['black', 'white', 'red', 'blue']

Keep in mind that the json.loads() function will not always return a dictionary. Specifically, the returning data type depends on the input string. For example, if the JSON string contains a flat value, it will be converted to the correspective Python primitive value:

import json
json_string = '15.5'
float_var = json.loads(json_string)

print(type(float_var)) # <class 'float'>

Similarly, a JSON string containing an array list will become a Python list:

import json
json_string = '[1, 2, 3]'
list_var = json.loads(json_string)
print(json_string) # <class 'list'>

Take a look at the conversion table below to see how JSON values are converted to Python data by json:

JSON ValuePython Data
number (integer)int
number (real)float

Transforming a JSON API Response Into a Python Dictionary

Consider that you need to make an API and convert its JSON response to a Python dictionary. In the example below, we will call the following API endpoint from the {JSON} Placeholder project to get some fake JSON data:

That RESTFul API returns the JSON response below:

  "userId": 1,
  "id": 1,
  "title": "delectus aut autem",
  "completed": false

You can call that API with the urllib module from the Standard Library and convert the resulting JSON to a Python dictionary as follows:

import urllib.request
import json

url = ""

with urllib.request.urlopen(url) as response:
     body_json =

body_dict = json.loads(body_json)
user_id = body_dict['userId'] # 1

urllib.request.urlopen() peforms the API call and returns an HTTPResponse object. Its read() method is then used to get the response body body_json, which contains the API response as a JSON string. Finally, that string can be parsed into a Python dictionary through json.loads() as explained earlier.

Similarly, you can achieve the same result with requests:

import requests
import json

url = ""
response = requests.get(url)

body_dict = response.json()
user_id = body_dict['userId'] # 1

Note that the .json() method automatically transforms the response object containing JSON data into the respective Python data structure.

Great! You now know how to parse a JSON API response in Python with both urllib and requests.

Loading a JSON File Into a Python Dictionary

Suppose you have some JSON data stored in a smartphone.json file as below:

  "name": "iPear 23",
  "colors": ["black", "white", "red", "blue"],
  "price": 999.99,
  "inStock": true,
  "dimensions": {
    "width": 2.82,
    "height": 5.78,
    "depth": 0.30
  "features": [
    "HD display",
    "Dual camera"

Your goal is to read the JSON file and load it into a Python dictionary. Achieve that with the snippet below:

import json

with open('smartphone.json') as file:
  smartphone_dict = json.load(file)

print(type(smartphone_dict)) # <class 'dict'>
features = smartphone_dict['features'] # ['5G', 'HD display', 'Dual camera']

The built-in open() library allows you to load a file and get its corresponding file object. The method then deserializes the text file or binary file containing a JSON document to the equivalent Python object. In this case, smartphone.json becomes a Python dictionary.

Perfect, parsing a JSON file in Python takes only a few lines of code!

From JSON Data to Custom Python Object

Now, you want to parse some JSON data into a custom Python class. This is what your custom Smartphone Python class looks like:

class Smartphone:
    def __init__(self, name, colors, price, in_stock): = name    
        self.colors = colors
        self.price = price
        self.in_stock = in_stock

Here, the goal is to convert the following JSON string to a Smartphone instance:

  "name": "iPear 23 Plus",
  "colors": ["black", "white", "gold"],
  "price": 1299.99,
  "inStock": false

To accomplish this task, you need to create a custom decoder. In detail, you have to extend the JSONDecoder class and set the object_hook parameter in the __init__ method. Assign it with the name of the class method containing the custom parsing logic. In that parsing method, you can use the values contained in the standard dictionary returned by to instantiate a Smartphone object.

Define a custom SmartphoneDecoder as below:

import json
class SmartphoneDecoder(json.JSONDecoder):
    def __init__(self, object_hook=None, *args, **kwargs):
        # set the custom object_hook method
        super().__init__(object_hook=self.object_hook, *args, **kwargs)

    # class method containing the 
    # custom parsing logic
    def object_hook(self, json_dict):
        new_smartphone = Smartphone(

        return new_smartphone

Note that you should use the get() method to read the dictionary values within the custom object_hook() method. This will ensure that no KeyErrors are raised if a key is missing from the dictionary. Instaed, None values will be returned.

You can now pass the SmartphoneDecoder class to the cls parameter in json.loads() to convert a JSON string to a Smartphone object:

import json

# class Smartphone:
# ...

# class SmartphoneDecoder(json.JSONDecoder): 
# ...

smartphone_json = '{"name": "iPear 23 Plus", "colors": ["black", "white", "gold"], "price": 1299.99, "inStock": false}'

smartphone = json.loads(smartphone_json, cls=SmartphoneDecoder)
print(type(smartphone)) # <class '__main__.Smartphone'>
name = # iPear 23 Plus

Similarly, you can use SmartphoneDecoder with json.load():

smartphone = json.load(smartphone_json_file, cls=SmartphoneDecoder)

Et voilà! You now know how to parse JSON data into custom Python objects!

Python Data to JSON

You can also go the other way around and convert Python data structures and primitives to JSON. This is possible thanks to the json.dump() and json.dumps() functions, which follows the conversion table below:

Python DataJSON Value
intnumber (integer)
floatnumber (real)
False false
None null 
Null None 

json.dump() allows you to write a JSON string to a file, as in the following example:

import json

user_dict = {
    "name": "John",
    "surname": "Williams",
    "age": 48,
    "city": "New York"

# serializing the sample dictionary to a JSON file
with open("user.json", "w") as json_file:
    json.dump(user_dict, json_file)

This snippet will serialize the Python user_dict variable into the user.json file.

Similarly, json.dumps() converts a Python variable to its equivalent JSON string:

import json

user_dict = {
    "name": "John",
    "surname": "Williams",
    "age": 48,
    "city": "New York"

user_json_string = json.dumps(user_dict)


Run this snippet and you will get:

This is exactly the JSON representation of the Python dict.

Note that you can also specify a custom encoder, but showing how to do it is not the purpose of this article. Follow the official documentation to learn more.

Is the json Standard Module the Best Resource for Parsing JSON in Python?

As is true in general for data parsing, JSON parsing comes with challenges that cannot be overlooked. For example, in case of invalid, broken, or non-standard JSON, the Python json module would fall short.

Also, you need to be careful when parsing JSON data from untrusted sources. This is because a malicious JSON string can cause your parser to break or consume a large amount of resources. This is just one of the challenges a Python JSON parser should take into account.

You could introduce custom logic to deal with these particular cases. At the same time, that might take too long and result in complex and unreliable code. For this reason, you should consider a commercial tool that makes JSON parsing easier, such as Web Scraper IDE.

Web Scraping IDE is specifically designed for developers and comes with a wide range of features to parse JSON content and more. This tool can save you tons of time and help you secure your JSON parsing process. Also, it comes with Bright Data’s unblocking proxy capabilities to call JSON APIs anonymously.

If you are in hurry, you might also be interested in our Data as a Service offer. Through this service, you can ask Bright Data to provide you with a custom dataset that fits your specific needs. Bright Data will take care of everything, from performance to data quality.

Parsing JSON data has never been easier!


Python enables you to natively parse JSON data through the json standard module. This exposes a powerful API to serialize and deserialize JSON content. Specifically, it offers the and json.reads() methods to deal with JSON files and JSON strings, respectively. Here, you saw how to use them to parse JSON data in Python in several real-world examples. At the same time, you also understood the limitations of this approach. This is why you may want to try a cutting-edge, fully-featured, commercial solution for data parsing, such as Bright Data’s Web Scraper IDE.

You might also be interested in

Cheerio vs. Puppeteer featured image
Web Data

Cheerio vs. Puppeteer for Web Scraping

A look at the differences between Puppeteer and Cheerio, by building a web scraper with both.
11 min read
How Tos

A Hands-On Guide to Web Scraping in R

In this tutorial, we’ll go through all the steps involved in web scraping in R with rvest with the goal of extracting product reviews from one publicly accessible URL from Amazon’s website.
7 min read
Python web scraping guide
How Tos

Web Scraping With Python – Step-By-Step Guide

Learn to perform web scraping with Python in order to gather data from multiple websites quickly, saving you both time, and effort.
18 min read
Using A Proxy Network To Manage And Scrape Social Media
How Tos

Web Scraping with Java Guide

This tutorial teaches you how to set up a Gradle project and install an HtmlUnit dependency. In the process, you’ll learn all about HtmlUnit and explore some of its advanced capabilities.
9 min read
Crunchbase study on women company founders
Web Data

New Study Shows Just 10% of Global Company Founders on Crunchbase are Women

Bright Data sheds light on gender gap among founders, highlighting need for diversity in business, as male founders receive 98% of funding on Crunchbase
9 min read
Web Data

Most organizations can’t operate without access to public web data: survey reveals

As big tech companies attempt to close off access to public web data, Bright Data commissioned a study by independent research firm Vanson Bourne, to determine the dependence of organizations – companies and non-profits alike – on publicly available data.
3 min read
What are HTTP cookies blog image
Web Data

What Are HTTP Cookies and How Do They Work?

We all love cookies, but what about HTTP Cookies? Here, you will delve into the basics of HTTP Cookies, exploring what they are, how they can be used, and seeing both their advantages and limitations.
7 min read
Web Data

What Is a Dataset? Definitive Guide

This article will cover what a dataset is, what types of datasets there are, and how you can make the most out of the data.
6 min read
What is data aggregation
Web Data

Data Aggregation – Definition, Use Cases, and Challenges

This blog post will teach you everything you need to know about data aggregation. Here, you will see what data aggregation is, where it is used, what benefits it can bring, and what obstacles it involves.
8 min read
What is a data parser featured image
Web Data

What Is Data Parsing? Definition, Benefits, and Challenges

In this article, you will learn everything you need to know about data parsing. In detail, you will learn what data parsing is, why it is so important, and what is the best way to approach it.
9 min read
What is a web crawler featured image
Web Data

What is a Web Crawler?

Web crawlers are a critical part of the infrastructure of the Internet. In this article, we will discuss: Web Crawler Definition A web crawler is a software robot that scans the internet and downloads the data it finds. Most web crawlers are operated by search engines like Google, Bing, Baidu, and DuckDuckGo. Search engines apply […]
5 min read
How Tos

The Ultimate Web Scraping With C# Guide

In this tutorial, you will learn how to build a web scraper in C#. In detail, you will see how to perform an HTTP request to download the web page you want to scrape, select HTML elements from its DOM tree, and extract data from them.
16 min read
Javascript and node.js web scraping guide image
How Tos

Web Scraping With JavaScript and Node.JS

We will cover why frontend JavaScript isn’t the best option for web scraping and will teach you how to build a Node.js scraper from scratch.
18 min read

More from Bright Data

Datasets Icon
Get immediately structured data
Easily access structured public web data for any use case. The datasets can be downloaded or delivered in a variety of formats. Get updated or new records from your preferred dataset based on a pre-defined schedule.
Web scraper IDE Icon
Build the scraper
Build scrapers in a cloud environment with code templates and functions that speed up the development. The solution is based on Bright Data’s Web Unlocker and proxy infrastructure making it easy to scale and never get blocked.
Web Unlocker Icon
Implement an automated unlocking solution
Boost the unblocking process with fingerprint management, CAPTCHA-solving, and IP rotation. Any scraper, written in any language, can integrate it via a regular proxy interface.

Ready to get started?