---
id: jsonquerylang
version: "2.1.0"
license: ISC
license_treatment: permissive
maintenance: aging
---

# jsonquerylang — A lightweight, flexible, and expandable JSON query language

License: permissive · Maintenance: aging · Downloads: 205.0K/mo

## What it is and what it does

jsonquerylang is a Python implementation of JSON Query, a domain-specific language for extracting and transforming JSON data. It lets you write queries that navigate JSON structures, filter arrays, sort results, and pick specific fields—similar to how you might use jq on the command line, but as a Python library. Queries can be written in a readable text syntax (e.g., `.friends | filter(.city == "New York")`) or as JSON arrays, and the library compiles them into executable functions.

The package depends only on regex and installs as a pure Python wheel, making it lightweight. It supports Python 3.7 through 3.13 and includes an API for compiling queries for reuse, parsing text queries into JSON form, and extending the language with custom functions and operators. The last release was 248 days ago and maintenance is aging, so updates may be infrequent.

Use it for:

- Extract and filter nested JSON API responses before passing them to downstream processing.
- Transform JSON configuration files by selecting specific fields and applying conditional logic.
- Sort and aggregate array data within JSON structures without writing imperative loops.
- Build reusable query templates by compiling queries once and executing them against multiple datasets.
- Implement custom query logic by adding domain-specific functions to the query language.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Executes queries against JSON data using a specialized query language, supporting filtering, sorting, field selection, and custom functions through both text and JSON syntax.

Yes, if you need a lightweight, permissive-licensed JSON query tool and can tolerate aging maintenance. The low install friction, lack of security issues, and broad Python version support make it a reasonable choice for filtering and transforming JSON. However, verify that the query syntax and custom function API meet your needs before committing to it in production, and be prepared for slower issue resolution.

## Install

pip install jsonquerylang
uv add jsonquerylang
poetry add jsonquerylang

## Installing jsonquerylang

Before you install: Low install friction—pure Python wheel with a single runtime dependency (regex). Last release was 248 days ago; maintenance status is aging, so expect slower response to issues.

License in practice: ISC license is permissive and poses no restrictions on commercial or private use, modification, or redistribution.

Quickstart:

pip install jsonquerylang

from jsonquerylang import jsonquery

data = {"friends": [{"name": "Chris", "age": 23, "city": "New York"}]}
result = jsonquery(data, '.friends | filter(.city == "New York") | pick(.name, .age)')
print(result)

Verify before relying:

- Whether custom operators and functions are stable and well-documented for production use.
- Performance characteristics when querying large JSON structures or deeply nested data.
- Community adoption and real-world usage patterns beyond the top-15000 popularity tier.

## Package facts

- License: ISC (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: aging
- Downloads: 205.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

json query language, filter and transform json, json data querying, json filtering and sorting, query json with expressions, json transformation tool, structured data querying, json-querying, data-transformation

[View on SkillFed](https://skillfed.io/packages/jsonquerylang) · [View on PyPI](https://pypi.org/project/jsonquerylang/)