XQA
Back to Python
2026-03-256 min read

JSON vs XML (Python Programming)

Learn JSON vs XML (Python Programming) step by step with clear examples and exercises.

Why This Matters

Understanding the differences between JSON and XML is crucial when working with data in Python programming. Both formats are widely used for data interchange, but they have distinct advantages and disadvantages that make them more suitable for certain tasks. Knowing when to use each format can significantly improve your coding efficiency and project outcomes.

Prerequisites

Before diving into JSON and XML in Python, you should have a good understanding of the following:

  1. Basic Python syntax and data structures (variables, lists, dictionaries)
  2. File I/O operations (reading and writing files)
  3. Understanding of HTTP requests (for JSON data retrieval from APIs)
  4. Familiarity with Python's built-in json module and external libraries like xml.etree.ElementTree

Core Concept

JSON (JavaScript Object Notation)

JSON is a lightweight data interchange format that is easy for humans to read and write, and easy for machines to parse and generate. It's based on a subset of the JavaScript Programming Language, Standard ECMA-262 3rd Edition - ECMAScript. JSON supports six data types:

  1. Number (integer, floating-point)
  2. String (textual data)
  3. Boolean (True or False)
  4. Array (ordered list of values)
  5. Object (unordered collection of key-value pairs)
  6. Null (empty value)

Python has built-in support for JSON via the json module, which provides functions to encode Python objects as JSON strings and decode JSON strings into native Python objects.

import json

data = {
"name": "John",
"age": 30,
"pets": ["Dog", "Cat"],
}

json_string = json.dumps(data)
print(json_string)

Output:

{"name":"John","age":30,"pets":["Dog","Cat"]}

JSON Example with Dates and Timestamps

JSON does not have a native way to represent dates or timestamps. However, it is common to use strings in the ISO 8601 format (e.g., "2022-03-01T12:00:00Z") to represent dates and times.

import datetime
data = {
"name": "John",
"birthday": datetime.datetime(1980, 6, 17),
}
json_string = json.dumps(data)
print(json_string)

Output:

{"name":"John","birthday":"1980-06-17T00:00:00"}

XML (eXtensible Markup Language)

XML is a markup language that defines a set of rules for encoding documents in a format that is both human-readable and machine-readable. It's used to store and transport data, and it's more flexible than JSON because it allows for the creation of custom tags. XML uses elements (enclosed in start and end tags), attributes, and text to define its structure.

Python can work with XML using libraries like xml.etree.ElementTree, which provides functions to parse and generate XML documents.

import xml.etree.ElementTree as ET

root = ET.Element("root")
person = ET.SubElement(root, "person")
person.set("name", "John")
person.set("age", "30")
pets_element = ET.SubElement(person, "pets")
for pet in ["Dog", "Cat"]:
pet_element = ET.SubElement(pets_element, "pet")
pet_element.text = pet

xml_string = ET.tostring(root, encoding="utf8").decode()
print(xml_string)

Output:

<root><person name="John" age="30"><pets><pet>Dog</pet><pet>Cat</pet></pets></person></root>

XML Example with Dates and Timestamps

XML also does not have a native way to represent dates or timestamps. However, it is common to use the ISO 8601 format (e.g., "2022-03-01T12:00:00Z") for dates and times within XML elements.

import datetime
root = ET.Element("root")
person = ET.SubElement(root, "person")
person.set("name", "John")
person.set("birthday", str(datetime.datetime(1980, 6, 17)))
pets_element = ET.SubElement(person, "pets")
for pet in ["Dog", "Cat"]:
pet_element = ET.SubElement(pets_element, "pet")
pet_element.text = pet

xml_string = ET.tostring(root, encoding="utf8").decode()
print(xml_string)

Output:

<root><person name="John" birthday="1980-06-17"><pets><pet>Dog</pet><pet>Cat</pet></pets></person></root>

Worked Example

Let's fetch JSON data from an API and process it using Python. We will use the requests library to make HTTP requests and the json module for parsing the response:

import json
import requests

response = requests.get("https://api.example.com/data")
data = json.loads(response.text)

for item in data["items"]:
print(item["name"])

In this example, we make a GET request to "https://api.example.com/data" and parse the response as JSON using json.loads(). We then iterate through the list of items and print their names.

Common Mistakes

  1. Forgetting to import necessary modules: Always ensure you have imported all required modules before using them in your code. In this lesson, we used json, requests, and xml.etree.ElementTree.
  2. Incorrectly encoding or decoding JSON data: Be mindful of the encoding when working with JSON strings, as improper encoding can lead to errors during parsing or serialization.
  3. Ignoring XML element order: Unlike JSON, XML does not preserve the order of elements within an XML document. If you need to maintain the order, consider using ordered dictionaries in Python 3.7+ or using a different data format like JSON.
  4. Using XML when JSON is more appropriate: JSON is generally preferred for data interchange because it's lighter and easier to parse. Use XML only when custom tags are required or when working with older systems that do not support JSON.
  5. Not handling exceptions: Always catch and handle exceptions to make your code more robust. This can help you avoid crashes and improve the user experience.

Common Mistakes - Subheadings

  • Incorrectly using XML attributes for JSON key-value pairs
  • Forgetting to close XML tags
  • Not properly escaping special characters in XML
  • Overlooking differences between Python 2 and Python 3 when working with JSON and XML

Practice Questions

  1. Write a Python script that reads an XML file, parses it using xml.etree.ElementTree, and prints the value of the "name" attribute for each "person" element.
  2. Given the following JSON object:
data = {
"employees": [
{"firstName": "John", "lastName": "Doe"},
{"firstName": "Anna", "lastName": "Smith"},
{"firstName": "Peter", "lastName": "Jones"}
]
}

Write a Python script that iterates through the employees list, prints each employee's full name (concatenated first and last names), and calculates the total number of characters in all employee names.

  1. Write a Python script that reads an XML file containing multiple "person" elements with custom tags for address information, and prints the name and address of each person.

FAQ

  1. Why is JSON more popular than XML? JSON is generally preferred for data interchange because it's lighter, easier to parse, and has a simpler syntax compared to XML.
  2. Can I mix JSON and XML within the same Python script? Yes, you can use both JSON and XML in the same Python script. However, be mindful of the differences between them when parsing and handling data.
  3. What are some other data formats apart from JSON and XML? Other popular data formats include YAML (Yet Another Markup Language), CSV (Comma-Separated Values), and Protocol Buffers (protobuf).
  4. Can I use Python to generate both JSON and XML files? Yes, you can use Python to generate both JSON and XML files using the built-in json module and external libraries like xml.etree.ElementTree.
  5. What is the difference between JSON.loads() and json.dump() functions in Python? json.loads() is used to parse a JSON string into a native Python object, while json.dump() is used to serialize a native Python object as a JSON string.
  6. Why does XML preserve the order of elements within an element, while JSON does not? XML preserves the order of elements within an element because it is a markup language that defines a tree-like structure. JSON, on the other hand, is a data interchange format that focuses on the key-value pair representation rather than the order of elements.
  7. What are some common issues when working with dates and timestamps in JSON and XML? Both JSON and XML do not have native ways to represent dates or timestamps. It is common to use strings in the ISO 8601 format (e.g., "2022-03-01T12:00:00Z") to represent dates and times, but this can lead to issues when parsing and handling the data if not properly handled.
JSON vs XML (Python Programming) | Python | XQA Learn