JSONPath Tester – Teste consultas JSONPath online

Execute expressões JSONPath sobre um JSON e veja os nós encontrados na hora. Monte a consulta certa antes de usá-la no código ou no jq.

Expressão JSONPath

JSON

3 resultado(s)

$['loja']['livros'][0]['titulo']
```
"Clean Code"
```
$['loja']['livros'][1]['titulo']
```
"O Hobbit"
```
$['loja']['livros'][2]['titulo']
```
"Refactoring"
```

Sintaxe suportada

$.chave · $['chave com espaço'] — propriedade
$.lista[0] · [-1] · [0,2] · [1:5] · [::2] — índice, união e fatia
$.lista[*] · $.* — todos os filhos
$..chave — descida recursiva
$.lista[?(@.preco > 80)] — filtro com == != < <= > >= e =~

Como usar esta ferramenta

Cole o JSON de origem
Escreva a expressão JSONPath (por exemplo, $.items[*].id)
Veja os nós que casaram com a consulta
Ajuste a expressão até o resultado ficar como você quer

Sobre esta ferramenta

O que é

JSONPath é uma linguagem de consulta para JSON, análoga ao XPath do XML. O $ representa a raiz, o ponto navega por campos, os colchetes acessam índices e o asterisco percorre todos os elementos.

Quando usar

Extrair um campo específico de uma resposta de API grande
Montar assert de teste automatizado sobre um payload
Configurar mapeamento de campos em uma ferramenta de integração
Explorar a estrutura de um JSON desconhecido
Validar a expressão antes de colocá-la em produção

Perguntas frequentes

O que $.items[*].id retorna?: O campo id de todos os elementos do array items. O asterisco percorre o array inteiro e o resultado é uma lista com um valor por elemento.
Qual a diferença entre $.. e $.?: Um ponto navega apenas para o filho direto. Dois pontos fazem busca recursiva em qualquer profundidade, então $..id encontra todo campo id do documento.
JSONPath é a mesma coisa que jq?: Não. JSONPath é só uma linguagem de seleção; jq é uma linguagem completa, com transformação, filtros e funções. Para extrair campos, as duas resolvem.

Ferramentas relacionadas

Sobre esta ferramenta

O que é

JSONPath é uma linguagem de consulta para JSON, análoga ao XPath do XML. O $ representa a raiz, o ponto navega por campos, os colchetes acessam índices e o asterisco percorre todos os elementos.

Quando usar

Extrair um campo específico de uma resposta de API grande
Montar assert de teste automatizado sobre um payload
Configurar mapeamento de campos em uma ferramenta de integração
Explorar a estrutura de um JSON desconhecido
Validar a expressão antes de colocá-la em produção

Perguntas frequentes

O que $.items[*].id retorna?

O campo id de todos os elementos do array items. O asterisco percorre o array inteiro e o resultado é uma lista com um valor por elemento.

Qual a diferença entre $.. e $.?

Um ponto navega apenas para o filho direto. Dois pontos fazem busca recursiva em qualquer profundidade, então $..id encontra todo campo id do documento.

JSONPath é a mesma coisa que jq?

Não. JSONPath é só uma linguagem de seleção; jq é uma linguagem completa, com transformação, filtros e funções. Para extrair campos, as duas resolvem.