Meta

• License Expression: MIT
  SPDXLicense Expression
• Author:James Prior
• Requires: Python >=3.8

Classifiers

• Development Status
  • 5 - Production/Stable
• Intended Audience
  • Developers
• License
  • OSI Approved :: MIT License
• Programming Language
  • Python
  • Python :: 3.8
  • Python :: 3.9
  • Python :: 3.10
  • Python :: 3.11
  • Python :: 3.12
  • Python :: 3.13
  • Python :: Implementation :: CPython
  • Python :: Implementation :: PyPy

Python JSONPath

A flexible JSONPath engine for Python.
We followRFC 9535 and test against theJSONPath Compliance Test Suite.

Table of Contents

• Install
• Links
• Related projects
• Examples
• License

Install

Install Python JSONPath usingpip:

pip install python-jsonpath

OrPipenv:

pipenv install -u python-jsonpath

Or fromconda-forge:

conda install -c conda-forge python-jsonpath

Links

• Documentation:https://jg-rp.github.io/python-jsonpath/.
• JSONPath Syntax:https://jg-rp.github.io/python-jsonpath/syntax/
• Change log:https://github.com/jg-rp/python-jsonpath/blob/main/CHANGELOG.md
• PyPi:https://pypi.org/project/python-jsonpath
• Source code:https://github.com/jg-rp/python-jsonpath
• Issue tracker:https://github.com/jg-rp/python-jsonpath/issues

Related projects

• JSONPath RFC 9535 - A Python implementation of JSONPath that follows RFC 9535 much more strictly. If you require maximum interoperability with JSONPath implemented in other languages - at the expense of extra features - choosejsonpath-rfc9535 overpython-jsonpath.

  jsonpath-rfc9535 matches RFC 9535's JSONPath model internally and is careful to use the spec's terminology. It also includes utilities for verifying and testing theJSONPath Compliance Test Suite. Most notably the nondeterministic behavior of some JSONPath selectors.

• JSON P3 - RFC 9535 implemented in TypeScript. JSON P3 does not include all the non-standard features of Python JSONPath, but does define some optionalextra syntax.

• Ruby JSON P3 - RFC 9535, RFC 6901 and RFC 6902 implemented in Ruby.

Examples

JSONPath

importjsonpathdata={"users":[{"name":"Sue","score":100},{"name":"John","score":86},{"name":"Sally","score":84},{"name":"Jane","score":55},]}user_names=jsonpath.findall("$.users[?@.score < 100].name",data)print(user_names)# ['John', 'Sally', 'Jane']

JSON Pointer

We include anRFC 6901 compliant implementation of JSON Pointer. See JSON Pointerquick start,guide andAPI reference

fromjsonpathimportpointerdata={"users":[{"name":"Sue","score":100},{"name":"John","score":86},{"name":"Sally","score":84},{"name":"Jane","score":55},]}sue_score=pointer.resolve("/users/0/score",data)print(sue_score)# 100jane_score=pointer.resolve(["users",3,"score"],data)print(jane_score)# 55

JSON Patch

We also include anRFC 6902 compliant implementation of JSON Patch. See JSON Patchquick start andAPI reference

fromjsonpathimportpatchpatch_operations=[{"op":"add","path":"/some/foo","value":{"foo":{}}},{"op":"add","path":"/some/foo","value":{"bar":[]}},{"op":"copy","from":"/some/other","path":"/some/foo/else"},{"op":"add","path":"/some/foo/bar/-","value":1},]data={"some":{"other":"thing"}}patch.apply(patch_operations,data)print(data)# {'some': {'other': 'thing', 'foo': {'bar': [1], 'else': 'thing'}}}

License

python-jsonpath is distributed under the terms of theMIT license.

Verified details

Maintainers

jg-rp

Unverified details

Project links

• Documentation
• Issues
• Source

• Download URL:python_jsonpath-1.3.1.tar.gz
• Upload date: Jun 22, 2025
• Size: 43.1 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.1.0 CPython/3.11.10

See more details on using hashes here.

• Download URL:python_jsonpath-1.3.1-py3-none-any.whl
• Upload date: Jun 22, 2025
• Size: 54.4 kB
• Tags: Python 3
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/6.1.0 CPython/3.11.10

See more details on using hashes here.