Jq Playground API

POST https://api.findutils.com/api/tools/jq-playground/execute

Returns the result of running a jq-style filter over a JSON document. Supports a jq subset: paths (.a.b, .[0], .[1:3], .[], .["a-b"]), pipes, map, select with ==, !=, >, >=, <, <= combined by and, or and not (jq truthiness: only false and null are false), sort_by/group_by/unique_by/min_by/max_by, keys/values/length/type/add/min/max/flatten/unique/reverse/sort, to_entries/from_entries/with_entries, has/contains/del, split/join/ltrimstr/rtrimstr, range/limit, + - * / arithmetic, the // fallback, and object/array/string construction. .[] yields an array rather than a stream, so .users[] | select(...) returns the matching elements as an array. A select that matches nothing gives result_type "empty". Not a full jq implementation: no reduce, try, foreach, recursive descent or user functions.

Open the tool Try it

Request body

application/json

json

string required

The JSON input document (text).
query

string optional

The jq filter, e.g. ".users[] | select(.age > 30) | .name". Default: "." (identity). Default ".".

Example arguments

Verified

{
  "json": {
    "users": [
      {
        "name": "Ann",
        "age": 31
      }
    ]
  },
  "query": ".users[0].name"
}

curl -X POST https://api.findutils.com/api/tools/jq-playground/execute \
  -H "Content-Type: application/json" \
  -d '{
    "json": "{\"users\":[{\"name\":\"Ann\",\"age\":31}]}",
    "query": ".users[0].name"
  }'

const response = await fetch('https://api.findutils.com/api/tools/jq-playground/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"json":"{\"users\":[{\"name\":\"Ann\",\"age\":31}]}","query":".users[0].name"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/jq-playground/execute",
    json={"json":"{\"users\":[{\"name\":\"Ann\",\"age\":31}]}","query":".users[0].name"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/jq-playground/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"json":"{\"users\":[{\"name\":\"Ann\",\"age\":31}]}","query":".users[0].name"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call jq_playground from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: jq-playground
MCP name: jq_playground
Category: Data
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Data tools

More to explore