JSONPath

Consulta un JSON con expresiones JSONPath: filtros, rebanadas y descenso recursivo, con las rutas de cada resultado.

Se procesa en tu navegador · Compruébalo Sin envíosDatos enviados: 0 · A otros dominios: 0Analítica: no existe · Anuncios: no existe

Prueba un ejemplo

Documento JSONExpresión JSONPath

Coincidencias

[
  "Sayings"
]

1 coincidencia

Rutas encontradas

$['store']['book'][0]['title']

Aprende

¿Qué es?

JSONPath es una forma corta de decir «dame este trozo del JSON». En vez de escribir bucles, escribes $.store.book[0].title y obtienes el valor. Esta herramienta evalúa la expresión sobre tu documento al momento y te dice dónde encontró cada resultado.

¿Para qué sirve?

Extraer un campo de una respuesta de API enorme mientras depuras.
Escribir aserciones en tests de API (Postman, REST Assured, k6 usan JSONPath).
Configurar herramientas que piden una ruta: Kubernetes (kubectl -o jsonpath), Grafana, AWS Step Functions.
Comprobar un filtro antes de pegarlo en tu código.

¿Cómo funciona por dentro?

La expresión se divide en segmentos que se aplican uno tras otro sobre la lista de nodos actual. Con $.book[?(@.price < 10)].title: $ es la raíz; .book entra en esa clave; [?(…)] conserva los hijos cuyo price sea menor que 10 (@ es cada hijo); .title toma su título. Un segmento con .. se aplica además a todos los descendientes. Esta herramienta implementa el núcleo del RFC 9535 sin funciones como length() ni match().

Errores comunes

Olvidar el $ inicial: store.book no es una ruta válida.
Usar comillas simples en el JSON: el documento debe ser JSON estricto (comillas dobles).
Esperar un valor y recibir una lista: JSONPath siempre devuelve una lista de coincidencias, aunque haya una sola o ninguna.
Comparar tipos distintos: @.price < "10" nunca es verdadero porque compara número con texto.
Que cada implementación difiera: antes del RFC 9535 había variaciones; comprueba la herramienta donde vas a usar la ruta.

Glosario

JSONPath:: Lenguaje para seleccionar partes de un documento JSON; está estandarizado en el RFC 9535.
Raíz ($):: El documento completo; toda expresión empieza por él.
Filtro:: Condición entre [?( )] que se evalúa para cada elemento; @ es el elemento actual.
Descenso recursivo (..):: Busca en todos los niveles de anidación
Ruta normalizada:: La forma única de nombrar un valor, como $['store']['book'][0].

Para saber más

Más en Formateadores

Formateadores

Aprende paso a paso en la rutaFormatos de datos y APIs