# JMESPath

JMESPath is a query language for JSON.

Repository: https://github.com/jmespath/jmespath.py
Canonical: https://ross.abutalabs.com/products/jmespath
Homepage: http://jmespath.org
Language: Python
License: MIT
License Family: permissive
Last push: 2026-04-20T23:12:00+00:00
Link (homepage): http://jmespath.org

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 78, release rhythm 35, longevity 100
- inputs: {"age_days": 4943, "days_push": 135, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2451, forks 204 (observed 2026-08-28T04:06:52.968067+00:00)

## What it is
JMESPath is a declarative query language for extracting and transforming elements from JSON documents, with a formal specification and compliance test suite. This is the Python implementation (with sibling libraries in PHP, JavaScript, Lua, and other languages) providing a search API over Python data structures.

## Use cases
- extract nested fields from json documents
- query json with a declarative path expression
- filter and project lists of json objects
- parse aws cli json output
- transform json api responses in python
- reuse compiled json queries across documents

## When to choose
- you need a standardized, spec-driven JSON query language with compliance tests
- you want declarative extraction from nested JSON without writing imperative code
- you work with AWS tooling, which uses JMESPath natively
- you need implementations across multiple languages with consistent behavior

## When to avoid
- you need to query JSON stored in a database rather than in-memory data
- you need full programming constructs like loops or complex conditionals
- your data is XML or another non-JSON format
- you need high-performance querying of very large JSON files

## Facets
- artifact type: library
- maturity: stable
- function: parser, json, search-engine, developer-tools
- domain: developer-tools, data-science, apis
- platform: python, php, cross-platform
- tags: json-query-language, jmespath, data-extraction, declarative-query, automation

## Member repositories
- jmespath/jmespath.py (main) score 67
- jmespath/jmespath.php (sdk) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:52.968067+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:30:11.127888+00:00, confidence not recorded.
  - readme: https://github.com/jmespath/jmespath.py (fetched 2026-08-28T04:06:52.968067+00:00, sha 930b152cfb06)
  - homepage: http://jmespath.org (fetched 2026-08-29T10:11:40.181693+00:00, sha 0047b3234793)
- Data as of 2026-08-30T08:39:29.467469+00:00.