Automatizar

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=False para que los acentos y la ñ se guarden legibles.
  • encoding="utf-8" al abrir archivos.
  • indent=2 para JSON legible.
  • Atrapa JSONDecodeError cuando 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.

← Más de Automatizar