Como manipular JSON com Python

✅ Atualizado para Python 3.13 (Dezembro 2025)
Biblioteca json nativa - trabalhe com APIs, configs e dados estruturados!

Salve salve Pythonista!

JSON (JavaScript Object Notation) é o formato mais usado em APIs e configurações! Biblioteca json é nativa.

Neste guia:

• ✅ loads/dumps - String ↔ Python
• ✅ load/dump - Arquivo ↔ Python
• ✅ Casos práticos - APIs, configs
• ✅ indent/ensure_ascii - Formatação

O JSON (JavaScript Object Notation) é um formato de dados muito popular na web, que permite a troca de informações estruturadas entre diferentes sistemas.

Ele é amplamente utilizado em aplicações RESTful, em bancos de dados NoSQL, em APIs e em muitos outros contextos.

No Python, a biblioteca padrão json oferece suporte para a manipulação de JSON de forma fácil e eficiente!

Neste artigo, vamos aprender como manipular JSON com Python. Você vai aprender a escrever dados em um arquivo JSON, ler dados de um arquivo JSON, converter uma string JSON em um objeto Python e também a converter um objeto Python em uma string JSON.

Então vamos nessa, que temos bastante conteúdo!

Vá Direto ao Assunto…

• Escrevendo dados em um arquivo JSON
• Lendo dados de um arquivo JSON
• Convertendo uma string JSON em um objeto Python
• Convertendo um objeto Python em uma string JSON
• Casos Práticos
• json vs dict

Escrevendo dados em um arquivo JSON

A primeira competência que vamos aprender é como escrever dados em um arquivo JSON usando Python.

Para isso, precisaremos da biblioteca json e do método dump(). Veja o exemplo abaixo:

1
2
3
4
5
6
7
8
9
10
11

import json

dados = {
    "nome": "João",
    "idade": 30,
    "cidade": "São Paulo"
}

arquivo = open("dados.json", "w")
json.dump(dados, arquivo)
arquivo.close()

No exemplo acima, criamos um dicionário chamado dados, que contém informações pessoais.

O arquivo dados.json será criado e as informações contidas no dicionário serão escritas nesse arquivo.

Note que utilizamos o modo "w" para abrir o arquivo em modo de escrita.

Lendo dados de um arquivo JSON

Agora que já sabemos como escrever dados em um arquivo JSON, vamos aprender como lê-los de um arquivo para dentro do Python.

Para isso, utilizamos o método load() da biblioteca json. Veja o exemplo a seguir:

1
2
3
4
5
6
7

import json

arquivo = open("dados.json", "r")
dados = json.load(arquivo)
arquivo.close()

print(dados)

No exemplo acima, abrimos o arquivo dados.json em modo de leitura ("r") e utilizamos o método json.load() para carregar os dados desse arquivo em uma variável chamada dados.

Por fim, exibimos os dados na tela com a função print().

Estou construindo o DevBook, uma plataforma que usa IA para criar ebooks técnicos — com código formatado e exportação em PDF. Te convido a conhecer!

Convertendo uma string JSON em um objeto Python

Além de escrever e ler dados de um arquivo JSON, podemos também converter uma string JSON em um objeto Python.

Para isso, utilizamos o método loads() da biblioteca json. Veja o exemplo abaixo:

1
2
3
4
5
6

import json

string_json = '{"nome": "Ana", "idade": 25, "cidade": "Rio de Janeiro"}'
dados = json.loads(string_json)

print(dados)

No exemplo acima, temos uma string chamada string_json, que contém os mesmos dados do exemplo anterior.

Utilizando o método json.loads(), convertemos essa string em um objeto Python. Em seguida, exibimos os dados na tela.

Convertendo um objeto Python em uma string JSON

Da mesma forma que podemos converter uma string JSON em um objeto Python, também podemos converter um objeto Python em uma string JSON.

Para isso, utilizamos o método dumps() da biblioteca json. Veja o exemplo a seguir:

1
2
3
4
5
6
7
8
9
10
11

import json

dados = {
    "nome": "Pedro",
    "idade": 35,
    "cidade": "Belo Horizonte"
}

string_json = json.dumps(dados)

print(string_json)

No exemplo acima, temos um dicionário chamado dados, que contém as mesmas informações dos exemplos anteriores.

Utilizando o método json.dumps(), convertemos esse dicionário em uma string JSON.

Por fim, exibimos a string na tela com a função print().

Está curtindo esse conteúdo?

Que tal receber 30 dias de conteúdo direto na sua Caixa de Entrada?

Sua assinatura não pôde ser validada.

Você fez sua assinatura com sucesso.

Assine as PyDicas e receba 30 dias do melhor conteúdo Python na sua Caixa de Entrada: direto e sem enrolação!

Seu nome

Seu e-mail

ASSINAR PYDICAS

Conclusão

Casos Práticos

1. Trabalhar com APIs

1
2
3
4
5
6
7
8
9
10
11

import json
import requests

# Fazer requisição
response = requests.get('https://api.example.com/users')

# Parse JSON
users = response.json()  # Ou: json.loads(response.text)

for user in users:
    print(f"{user['name']} - {user['email']}")

2. Arquivo de Configuração

1
2
3
4
5
6
7
8
9
10
11
12
13

import json

# Ler config
with open('config.json', 'r') as f:
    config = json.load(f)

print(config['database']['host'])
print(config['api_key'])

# Atualizar e salvar
config['debug'] = False
with open('config.json', 'w') as f:
    json.dump(config, f, indent=2)

3. JSON Nested (Aninhado)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

import json

data = {
    'usuario': {
        'nome': 'Alice',
        'endereco': {
            'rua': 'Rua A',
            'cidade': 'São Paulo'
        }
    }
}

print(data['usuario']['endereco']['cidade'])  # São Paulo

# Serializar com indentação
json_str = json.dumps(data, indent=2, ensure_ascii=False)
print(json_str)

4. Validação de JSON

1
2
3
4
5
6
7
8
9

import json

json_string = '{"nome": "Bob", "idade": 25}'

try:
    dados = json.loads(json_string)
    print("JSON válido!")
except json.JSONDecodeError as e:
    print(f"JSON inválido: {e}")

json vs dict

JSON é apenas uma string formatada. Dict é um objeto Python.

1
2
3
4
5
6
7
8
9
10
11

import json

# Dict Python
dict_py = {'nome': 'Alice', 'idade': 25}

# JSON (string)
json_str = '{"nome": "Alice", "idade": 25}'

# Conversão
json_from_dict = json.dumps(dict_py)  # dict → JSON
dict_from_json = json.loads(json_str)  # JSON → dict

Conclusão

Neste guia da biblioteca json, você aprendeu:

✅ loads() - String JSON → Python
✅ dumps() - Python → String JSON
✅ load()/dump() - Arquivos
✅ indent - Formatar saída
✅ Casos práticos - APIs, configs, validação

Principais lições:

• JSON é string, dict é objeto
• loads/dumps para strings
• load/dump para arquivos
• indent=2 deixa JSON legível
• ensure_ascii=False preserva acentos

Próximos passos:

• Explore [CSV][csv-post]{:target=”_blank”} para dados tabulares
• Aprenda requests para APIs
• Pratique Pydantic para validação
• Estude jsonschema para schemas

Neste artigo, aprendemos como manipular JSON com Python!

Com a biblioteca json, podemos realizar essas tarefas de forma simples e eficiente.

Com o tempo e a prática, você se tornará um especialista em manipulação de JSON com Python!

Por Vinícius Ramos em 02/11/2023

Engenheiro de Computação pela UnB com especialização em Inteligência Artificial. Sr. Software Engineer com 10+ anos de experiência desenvolvendo sistemas críticos em Python e Django. Atuei no Banco do Brasil liderando equipes para monitoramento de mainframe, trabalhei como desenvolvedor sênior em projetos forenses para a Polícia Federal, e atualmente sou engenheiro de software na Labcorp (Estados Unidos), desenvolvendo soluções escaláveis para testes genéticos. Fundador da Python Academy, compartilhando conhecimento técnico com a comunidade brasileira desde 2018.

Minhas redes: