Python Academy · Lesson

Handling Nested JSON Structures

Navigate and transform complex nested JSON objects.

Handling Nested JSON Structures is a free Python Academy lesson on CoddyKit — lesson 2 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Python Academy learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Introduction

Real-world JSON is deeply nested. Knowing how to navigate, transform, and validate nested structures is essential.

Accessing Nested Keys

data['user']['address']['city'] navigates nested dicts. Use .get() at each level to handle missing keys.

import json
data = {'user': {'address': {'city': 'NYC', 'zip': '10001'}}}
print(data['user']['address']['city'])

Safe Nested Access

data.get('user', {}).get('address', {}).get('city') chains .get() calls safely.

data = {'user': {'name': 'Alice'}}
city = data.get('user', {}).get('address', {}).get('city', 'unknown')
print(city)

Iterating Arrays of Objects

JSON arrays of objects are lists of dicts. Iterate with a for loop.

import json
data = json.loads('[{"name":"Alice"},{"name":"Bob"}]')
for user in data:
    print(user['name'])

Flattening Nested JSON

Write a recursive function to flatten nested dicts into a flat dict with dotted keys.

def flatten(d, prefix=''):
    result = {}
    for k, v in d.items():
        key = f'{prefix}.{k}' if prefix else k
        if isinstance(v, dict):
            result.update(flatten(v, key))
        else:
            result[key] = v
    return result
print(flatten({'a': {'b': {'c': 1}}, 'd': 2}))

Filtering Arrays

[user for user in data if user.get('active')] filters a JSON array by a condition.

data = [{'name':'A','active':True},{'name':'B','active':False}]
active = [u for u in data if u.get('active')]
print(active)

Transforming Nested Data

Extract a field from each nested object: [item['name'] for item in data]

data = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
names = [d['name'] for d in data]
print(names)

Schema Validation with jsonschema

pip install jsonschema. jsonschema.validate(instance, schema) raises ValidationError on invalid data.

# from jsonschema import validate
# schema = {'type':'object','required':['name']}
# validate({'name':'Alice'}, schema)  # OK
# validate({}, schema)  # raises ValidationError
print('schema validation demo')

Deeply Updating Nested Dicts

Shallow dict.update() doesn't merge nested dicts. Write a recursive deep_update for nested merging.

def deep_update(base, override):
    for k, v in override.items():
        if isinstance(v, dict) and isinstance(base.get(k), dict):
            deep_update(base[k], v)
        else:
            base[k] = v
    return base
result = deep_update({'a': {'x': 1}}, {'a': {'y': 2}})
print(result)

jq-style Queries with Python

For complex queries use the jq library or a custom recursive search: find_all(data, 'key').

def find_all(obj, key):
    if isinstance(obj, dict):
        if key in obj: yield obj[key]
        for v in obj.values(): yield from find_all(v, key)
    elif isinstance(obj, list):
        for item in obj: yield from find_all(item, key)
data = {'a': {'name': 'x'}, 'b': [{'name': 'y'}]}
print(list(find_all(data, 'name')))

Serializing to NDJSON

Newline-delimited JSON (NDJSON): one JSON object per line. Write with json.dumps(obj) + '\n'.

import json
objects = [{'id': 1}, {'id': 2}, {'id': 3}]
ndjson = '\n'.join(json.dumps(o) for o in objects)
print(ndjson)

Quick Check

What does data.get('key', {}).get('nested') return when 'key' is missing?

Recap

Nested JSON: chain .get() for safe access. Iterate arrays with for. Flatten with recursion. Filter with list comprehension. Use jsonschema for validation.

Keep Going

Keep it up! Move on to the next lesson.

Frequently asked questions

Is the “Handling Nested JSON Structures” lesson free?

Yes — the full text of “Handling Nested JSON Structures” is free to read here on the web, and the Python Academy course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Python Academy course, upgrade to CoddyKit PRO.

What will I learn in “Handling Nested JSON Structures”?

Navigate and transform complex nested JSON objects. You practise Python Academy with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Python Academy?

No prior experience is required. Python Academy on CoddyKit is structured for beginners through advanced learners; this is — lesson 2 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Handling Nested JSON Structures” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Python Academy lesson?

Yes. Every Python Academy lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to Python Academy