Como usar: Testador de JSONPath
- Cole seu JSON (ou mantenha o exemplo da livraria).
- Digite uma expressão JSONPath ou clique em um exemplo.
- Veja os valores encontrados e o caminho exato de cada um, depois copie o resultado.
Sintaxe do JSONPath
| Expressão | Significado |
|---|---|
$ | A raiz do documento |
.chave ou ['chave'] | Uma propriedade filha (use colchetes para chaves com espaços ou pontos) |
[0], [-1] | Elemento do array pelo índice; negativo conta a partir do fim |
[0:3], [-2:] | Fatia do array |
* | Curinga: todos os filhos |
.. | Descida recursiva: busca em qualquer profundidade ($..price) |
[?(@.price < 10)] | Filtro: elementos para os quais a expressão é verdadeira; @ é o elemento atual |
[0,2], ['a','b'] | União de vários índices ou chaves |
Filtros
Os filtros aceitam comparações (==, !=, <, >=…), operadores lógicos (&&, ||) e verificações de existência ([?(@.isbn)]). Este testador avalia filtros em um modo seguro e isolado, então as expressões não conseguem executar código arbitrário.
As implementações variam
O JSONPath foi informal por anos, até a RFC 9535 (2024) padronizá-lo. As bibliotecas ainda divergem em casos específicos, como sintaxe de filtros, expressões regulares e o comportamento de chaves ausentes. Esta ferramenta usa o JSONPath Plus, uma implementação JavaScript muito utilizada; verifique a biblioteca que você vai usar (Jayway em Java, jsonpath-ng em Python, AWS Step Functions, Postman) para conhecer o dialeto exato.
JSONPath vs jq
jq é uma linguagem completa de transformação para a linha de comando; o JSONPath apenas seleciona valores. $.store.book[*].title em JSONPath corresponde a .store.book[].title no jq. Para navegar por um documento e copiar caminhos com cliques, use o visualizador de JSON; para a sintaxe de mapeamento do Make, Zapier e n8n, use o localizador de caminho JSON.
Também pesquisado como: jsonpath online, avaliador jsonpath, testar jsonpath, filtro jsonpath, consulta json, expressão jsonpath, testar expressão jsonpath.
Ferramentas que combinam com: Testador de JSONPath
- Formatação JSON — Cole o JSON aqui para formatá-lo, compactá-lo ou validá-lo.
- Validador JSON Schema — Cole um schema e um JSON para ver exatamente quais valores quebram cada regra, ou gere um schema inicial a partir de dados de exemplo.
- JSON Diff — Descubra exatamente o que mudou entre dois documentos JSON — respostas de API, versões de configuração, fixtures ou exportações — em uma lista de caminhos com os valores antigos e novos.
- Validador OpenAPI / Swagger — Cole uma especificação de API para checar contra o schema oficial do OpenAPI, encontrar referências quebradas e parâmetros de path inconsistentes, e ver todos os endpoints de uma vez.
Perguntas frequentes
O que significa $.. no JSONPath?
$..price encontra todas as propriedades price em qualquer profundidade.Como filtrar um array no JSONPath?
$.items[?(@.price > 10)] seleciona os itens cujo preço é maior que 10.