Lesson 2. Introduction to JSON Data in Python

Learning Objectives

After completing this tutorial, you will be able to:

  • Describe the key structure elements of a JSON data structure: name/value pairs.
  • Identify the components of the hierarchical JSON data structures including: objects, arrays and data elements.
  • List some of the core data types that a JSON data structure can store including: boolean, numeric and string.

What You Need

You will need a computer with internet access to complete this lesson.

In this lesson, you will explore the machine readable JSON data structure. Machine readable data structures are more efficient - particularly for larger data that contain hierarchical structures.


Remember that in the first lesson in this module, you learned about RESTful APIs. You explored the concept of a request and then a subsequent response. The request to an RESTful API is composed of a URL and the associated parameters required to access a particular subset of the data that you wish to access.

When you send the request, the web API returns one of the following:

  1. The data that you requested or
  2. A failed to return message which tells us that something was wrong with your request.

About JSON

Before going any further, revisit the JavaScript Object Notation or JSON data structure that you learned about in the introductory lesson in this module. JSON is an ideal format for larger data that have a hierarchical structured relationship.

In Python, JSON data is similar to a dictonary because it has keys (i.e. names) and values, but it is encoded as a string.

The Python library json is helpful to convert data from lists or dictonaries into JSON strings and JSON strings into lists or dictonaries. Pandas can also be used to convert JSON data (via a Python dictionary) into a Pandas DataFrame.

The structure of a JSON object is as follows:

  • The data are in name/value pairs using colons :.
  • Data objects are separated by commas.
  • Curly braces {} hold the objects.
  • Square brackets [] can be used to indicate an array that contains a group of objects.
  • Each data element is enclosed with quotes "" if it is a character, or without quotes if it is a numeric value.

Example of a name/value pair using a colon:

 { "name":"Chaya" }

Example of objects separated by commas:

{ "name":"Chaya", "age":12, "city":"Boulder", "type":"Canine" }

Notice that the data above are structured. Thus, each element contains a particular object name (name, age, city, etc) and values are associated with these names. This is similar to column headings in a CSV file.

However, the JSON structure can also be nested using square brackets to indicate an array that contains a group of objects, like this:

    { "firstName":"Serena", "lastName":"Williams" },
    { "firstName":"Boe", "lastName":"Diddly" },
    { "firstName":"Al", "lastName":"Gore" }

The ability to store nested or hierarchical data within a text file structure makes JSON a powerful format to use as you are working with larger datasets.

Data Tip: The GeoJSON data structure is a powerful data structure that supports spatial data. GeoJSON can be used to create maps just like shapefiles can. This format is often used for web mapping applications like Leaflet (which you will learn about later in this module).

JSON Data Structures

JSON can store any of the following data types:

  • strings
  • numbers
  • objects (JSON object)
  • arrays
  • booleans (TRUE / FALSE)
  • null

Note that in the example below, the word “Chaya”, which is the value associated with “name”, is in quotes "". This specifies that “Chaya” is a string (characters rather than numeric).

 { "name":"Chaya" }

In this example, the value 12, associated with “age”, is not in quotes. This specifies that this value is a number or of type numeric.

{ "name":"Chaya", "age":12, "city":"Boulder", "type":"Canine" }

In the next lesson, you will work with JSON structured data, accessed via a RESTful API. A snippet of the data that you will work with is below. Notice that the JSON is enclosed in brackets [] to indicate an array containing a group of objects.


Leave a Comment