Consulta JSON

Extrae exactamente los valores que necesitas de un JSON usando JSONPath.

Resultado

Ejemplos de uso

Extraer solo los campos que necesitas de una gran respuesta de API

En vez de revisar todo el JSON de la respuesta, obtén exactamente lo que necesitas de una vez con una ruta como $.data.items[*].id.

Filtrar elementos que cumplen una condición

Usa una expresión de filtro como $.products[?(@.price<10000)] para reducir a los elementos que cumplen una condición de precio, stock o cualquier otra.

Encontrar una clave específica en cualquier parte de una estructura anidada

La sintaxis de descenso recursivo, $..price, encuentra cada clave con ese nombre en cualquier lugar del documento, sin importar la profundidad o posición.

Obtener el último elemento de un arreglo

Usa $.orders[-1:] para sacar la entrada más reciente de un arreglo creciente de registros o pedidos sin contar cuántos elementos tiene.

Extraer varios campos concretos a la vez

Una expresión de unión como $.user['name','email','id'] devuelve solo esos tres campos de un objeto, omitiendo todo lo demás de un registro de usuario grande.

Comprobar la forma de una carga de API desconocida

¿No sabes a qué profundidad está anidado un campo en una respuesta que nunca habías visto? Empieza con $..fieldName para localizarlo en cualquier sitio y luego acota a la ruta exacta cuando veas dónde está.

Preguntas frecuentes

¿El JSON y la expresión que ingreso se envían a un servidor?

No. La consulta se ejecuta completamente en tu navegador, y lo que ingresas nunca se envía a un servidor.

No recuerdo la sintaxis de JSONPath.

Patrones comunes: $ significa todo el documento, .clave una clave específica, [*] todos los elementos de un array, [0] el primer elemento, [?(@.price<10)] filtra elementos que cumplen una condición, y $..clave encuentra cada clave con ese nombre a cualquier profundidad.

Mi resultado está vacío, ¿por qué?

Eso puede significar que la ruta no apunta a ningún dato real, o que la expresión tiene un error de sintaxis; ambos casos se muestran como resultado vacío. Prueba a acortar la ruta paso a paso para ver dónde deja de coincidir.

¿El resultado de la consulta siempre es un array?

Sí. JSONPath recopila cada valor coincidente en un array, incluso cuando coincide exactamente un valor; obtendrás un array de longitud uno.

¿Es sintaxis JSONPath, JMESPath o jq?

JSONPath, evaluado con la biblioteca jsonpath-plus. Admite la sintaxis estándar $, ., [*], [n] y $..key, además de extensiones como expresiones de filtro ([?(@.price<10)]) y expresiones de script, pero no es compatible con la sintaxis de consulta de jq ni de JMESPath, que usan operadores distintos.

¿Puedo filtrar un arreglo con más de una condición?

Sí: combina condiciones con && o || dentro de una expresión de filtro, por ejemplo $.products[?(@.price<100 && @.inStock==true)] para encontrar los elementos que son baratos y además están en stock.

¿La ruta admite índices negativos o rebanadas (slices) de arreglo?

Sí. [-1] se refiere al último elemento y la sintaxis de rebanada como [1:3] o [-2:] funciona igual que en Python, lo que te permite tomar un rango de elementos sin conocer la longitud exacta del arreglo.