Trabajar con JSON en Python: leer, escribir y convertir
Cómo manejar datos JSON en Python con el módulo json: convertir entre texto y objetos de Python, leer y escribir archivos, y los detalles de codificación que rompen los acentos.
JSON es el formato en que hablan las APIs, los archivos de configuración y medio internet. Python trae el módulo json incluido para convertir entre JSON y estructuras de Python sin instalar nada. Aquí lo esencial, con los detalles que hacen fallar los scripts con datos en español.
import json
Los cuatro métodos que necesitas
Todo el módulo se reduce a cuatro funciones, y confundirlas es el tropiezo número uno. La diferencia es: ¿trabajas con texto (una cadena) o con un archivo?
json.loads()— de texto JSON a objeto Python (la “s” es de string).json.dumps()— de objeto Python a texto JSON.json.load()— de archivo JSON a objeto Python (sin “s”).json.dump()— de objeto Python a archivo JSON.
Regla de memoria: con “s” trabajas con cadenas (strings); sin “s”, con archivos. Esa letra es la que todos confunden.
De texto JSON a Python
texto = '{"nombre": "Ana", "edad": 30, "activo": true}'
datos = json.loads(texto)
print(datos["nombre"]) # Ana
print(type(datos)) # <class 'dict'> — ahora es un diccionario
loads convierte el texto en un diccionario de Python, y a partir de ahí accedes a los datos con corchetes. Fíjate que el true de JSON se vuelve True de Python automáticamente.
De Python a texto JSON
datos = {"nombre": "Luis", "ciudad": "Caracas"}
texto = json.dumps(datos)
print(texto) # {"nombre": "Luis", "ciudad": "Caracas"}
Para que el JSON salga legible (con sangría) en vez de todo en una línea, usa indent:
texto = json.dumps(datos, indent=2)
Y aquí el detalle que arruina los acentos: por defecto, dumps escapa los caracteres no ASCII, así que “Caracas” sale bien pero “José” se convierte en José. Para mantener los acentos y la ñ legibles:
texto = json.dumps(datos, ensure_ascii=False)
El ensure_ascii=False es imprescindible para datos en español. Sin él, tu JSON queda lleno de ñ y é ilegibles.
Leer y escribir archivos JSON
Para un archivo, usas las versiones sin “s”, con open:
# Leer
with open("config.json", encoding="utf-8") as archivo:
config = json.load(archivo)
# Escribir
with open("salida.json", "w", encoding="utf-8") as archivo:
json.dump(datos, archivo, indent=2, ensure_ascii=False)
El encoding="utf-8" al abrir el archivo, más el ensure_ascii=False al escribir, es la combinación que mantiene los acentos correctos de principio a fin.
Un ejemplo real: API y guardar
El flujo típico de automatización: pedir datos a una API y guardarlos:
import json
import requests
respuesta = requests.get("https://api.ejemplo.com/usuarios", timeout=10)
usuarios = respuesta.json() # requests ya convierte el JSON por ti
with open("usuarios.json", "w", encoding="utf-8") as archivo:
json.dump(usuarios, archivo, indent=2, ensure_ascii=False)
print(f"Guardados {len(usuarios)} usuarios.")
Nota útil: cuando usas requests, su método .json() ya hace el loads por ti, así que no tienes que convertir a mano la respuesta. Lo ves en detalle en el artículo de peticiones HTTP con requests.
El error más común: JSON inválido
Si el texto no es JSON válido (una coma de más, comillas simples en vez de dobles), loads lanza json.JSONDecodeError:
try:
datos = json.loads(texto)
except json.JSONDecodeError as e:
print(f"JSON inválido: {e}")
Recuerda que JSON exige comillas dobles siempre ("clave", no 'clave') y no permite coma final tras el último elemento. Son las dos causas más frecuentes de JSON roto.
Resumen
- Con “s” (
loads/dumps) trabajas con texto; sin “s” (load/dump) con archivos. ensure_ascii=Falsepara que los acentos y la ñ se guarden legibles.encoding="utf-8"al abrir archivos.indent=2para JSON legible.- Atrapa
JSONDecodeErrorcuando el texto podría venir mal.
Con esto manejas configuración, respuestas de APIs y cualquier intercambio de datos JSON. Es uno de los módulos que más vas a usar en automatizaciones que tocan internet.
¿Necesitas recorrer un JSON muy anidado o convertir entre JSON y CSV? Escríbeme desde contacto y lo vemos.