Jsonpath Tester - Complete Guide

JSONPath tester evaluates JSONPath expressions against JSON documents to query and extract specific data. Like XPath for XML, JSONPath provides a query language for navigating JSON structures, extracting arrays, filtering objects, and accessing nested values.

How It Works

Parse JSON input, then parse and evaluate JSONPath expression. Traverse JSON tree following path components: root ($), child (.), recursive descent (..), array index ([n]), wildcards (*), filters ([?()]). Return all matching values.

Technical Details

JSONPath syntax: $ = root, .property = child, ..property = recursive, [n] = array index, [*] = all items, [start:end] = slice, [?(@.price<10)] = filter. Implementations vary (Goessner, Jayway). Some support functions like length(), min(), max().

Common Use Cases

1. API Testing: Extract specific values from JSON responses.
   • Example: $.data.users[*].name
2. Data Transformation: Query nested structures for ETL.
   • Example: $.orders[?(@.status=="pending")]
3. Configuration: Access specific config values.
   • Example: $.database.connection.host
4. Log Analysis: Extract fields from JSON logs.
   • Example: $.events[*].timestamp

Code Examples

JSONPath Queries

// Using jsonpath-plus library
import { JSONPath } from 'jsonpath-plus';

const data = {
  store: {
    books: [
      { title: 'Book A', price: 10, category: 'fiction' },
      { title: 'Book B', price: 15, category: 'tech' },
      { title: 'Book C', price: 8, category: 'fiction' }
    ],
    location: { city: 'Sydney' }
  }
};

// Basic queries
JSONPath({ path: '$.store.books[0].title', json: data });
// ['Book A']

JSONPath({ path: '$.store.books[*].title', json: data });
// ['Book A', 'Book B', 'Book C']

// Filter: books under $12
JSONPath({ path: '$.store.books[?(@.price<12)]', json: data });
// [{ title: 'Book A', ... }, { title: 'Book C', ... }]

// Recursive: all prices
JSONPath({ path: '$..price', json: data });
// [10, 15, 8]

// Slice: first two books
JSONPath({ path: '$.store.books[0:2]', json: data });
// [{ title: 'Book A', ... }, { title: 'Book B', ... }]

Common JSONPath patterns. jsonpath-plus is a popular JS library implementing extended JSONPath.

Tips & Best Practices

• Use $ as root, not omitting it
• Test with simple paths first, then add complexity
• Recursive descent (..) can be slow on large data
• Check library documentation for filter syntax
• Bracket notation for special characters: $["my-key"]

Common Mistakes to Avoid

• Forgetting root $ in path
• Wrong filter syntax for library
• Expecting single value when array returned
• Not escaping special characters in keys
• Assuming all implementations are identical

When to Use This Tool

Use JSONPath tester when querying JSON APIs, extracting specific data from complex JSON structures, testing JSONPath expressions, or learning JSONPath syntax.

Frequently Asked Questions

How is JSONPath different from jq?

JSONPath is a query language spec, jq is a full processing tool. JSONPath extracts data, jq transforms it. Both navigate JSON but jq has more power (conditionals, functions, output formatting).

What does recursive descent (..) do?

Searches all descendants. $..name finds all "name" properties at any depth. Useful when structure varies or you want all occurrences. Can be slow on large documents.

How do filters work?

Filter expressions [?()] select items matching criteria. @.price<10 means current item price less than 10. Supports ==, !=, <, >, <=, >=, && (and), || (or).

Are there different JSONPath versions?

Yes, implementations vary. Goessner original, Jayway (Java), JSONPath-Plus (JS) have differences. IETF is standardizing. Check your library's documentation.

Get Started

Ready to try Jsonpath Tester? Use the tool now - it's free, fast, and works right in your browser.

---

Last updated: June 27, 2026