JSONPath for Python

1.1.5 · active · verified Thu Apr 09

jsonpath-python is a lightweight and powerful implementation of the JSONPath specification for Python, enabling users to extract data from JSON objects using XPath-like expressions. It is actively maintained, with version 1.1.5 being the current release, and follows a moderate release cadence addressing fixes, performance, and security.

Warnings

breaking A critical security fix in version 1.1.5 (released 2026-03-17) prevents Remote Code Execution (RCE) via `eval()` in filter expressions. Prior versions (<=1.1.4) were vulnerable if untrusted JSONPath expressions containing filter clauses were processed. Update immediately to prevent potential security breaches.
Fix: Upgrade to version 1.1.5 or newer: `pip install --upgrade jsonpath-python`.
breaking As of version 1.1.0, sorting arrays with mixed data types (e.g., numbers and strings) in filter expressions will now raise a `JSONPathTypeError`. Previously, this behavior was undefined and could lead to inconsistent or erroneous results without explicit error notification.
Fix: Ensure that arrays intended for sorting in filter expressions contain elements of a consistent, comparable type. Handle `JSONPathTypeError` if mixed-type data is expected, or pre-process data to normalize types before applying JSONPath expressions.

Install

pip install jsonpath-python Install stable version

Imports

JSONPath
```
from jsonpath import JSONPath
```

Quickstart

Initializes a JSONPath object with an expression and uses its `parse` method to extract matching values from a dictionary. The `parse` method returns a list of all matched items. Other methods like `match` (returns first match) and `findall` (returns generator) are also available.

from jsonpath import JSONPath

data = {
    "store": {
        "book": [
            {"category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95},
            {"category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99}
        ],
        "bicycle": {"color": "red", "price": 19.95}
    }
}

# Find all authors of books
path_expression = '$..book[*].author'
path = JSONPath(path_expression)
authors = path.parse(data)
print(f"Authors: {authors}")

# Find all prices
all_prices = JSONPath('$..price').parse(data)
print(f"All prices: {all_prices}")

view raw JSON →