Consulta JSON

Extraia exatamente os valores que você precisa de um JSON usando JSONPath.

Resultado

Exemplos de uso

Extrair apenas os campos que você precisa de uma grande resposta de API

Em vez de vasculhar todo o JSON da resposta, obtenha exatamente o que precisa de uma vez com um caminho como $.data.items[*].id.

Filtrar itens que atendem a uma condição

Use uma expressão de filtro como $.products[?(@.price<10000)] para restringir aos itens que atendem a uma condição de preço, estoque ou qualquer outra.

Encontrar uma chave específica em qualquer lugar de uma estrutura aninhada

A sintaxe de descida recursiva, $..price, encontra toda chave com esse nome em qualquer lugar do documento, independente da profundidade ou posição.

Pegar o último item de um array

Use $.orders[-1:] para obter a entrada mais recente de um array crescente de logs ou pedidos sem contar quantos itens ele tem.

Extrair vários campos específicos de uma só vez

Uma expressão de união como $.user['name','email','id'] retorna apenas esses três campos de um objeto, ignorando todo o resto de um registro de usuário grande.

Verificar a estrutura de um payload de API desconhecido

Não sabe quão fundo um campo está aninhado em uma resposta que você nunca viu? Comece com $..fieldName para localizá-lo em qualquer lugar e depois reduza ao caminho exato quando vir onde ele está.

Perguntas frequentes

O JSON e a expressão que eu insiro são enviados para um servidor?

Não. A consulta roda inteiramente no seu navegador, e o que você insere nunca é enviado a um servidor.

Não me lembro da sintaxe do JSONPath.

Padrões comuns: $ significa o documento inteiro, .chave uma chave específica, [*] todos os itens de um array, [0] o primeiro item, [?(@.price<10)] filtra itens que atendem a uma condição, e $..chave encontra toda chave com esse nome em qualquer profundidade.

Meu resultado está vazio, por quê?

Isso pode significar que o caminho não aponta para nenhum dado real, ou que a expressão tem um erro de sintaxe — ambos aparecem como resultado vazio. Tente encurtar o caminho um passo de cada vez para ver onde ele para de corresponder.

O resultado da consulta é sempre um array?

Sim. O JSONPath reúne todo valor correspondente em um array, mesmo quando exatamente um valor corresponde — você receberá um array de tamanho um.

Esta é a sintaxe JSONPath, JMESPath ou jq?

JSONPath, avaliada com a biblioteca jsonpath-plus. Ela suporta a sintaxe padrão $, ., [*], [n] e $..key, além de extensões como expressões de filtro ([?(@.price<10)]) e expressões de script — mas não é compatível com a sintaxe de consulta do jq nem do JMESPath, que usam operadores diferentes.

Posso filtrar um array por mais de uma condição?

Sim — combine condições com && ou || dentro de uma expressão de filtro, por exemplo $.products[?(@.price<100 && @.inStock==true)] para encontrar itens que sejam ao mesmo tempo baratos e estejam em estoque.

O caminho suporta índices negativos de array ou fatias?

Sim. [-1] se refere ao último elemento e a sintaxe de fatia, como [1:3] ou [-2:], funciona do mesmo jeito que no Python, permitindo pegar um intervalo de itens sem saber o tamanho exato do array.