JSONPath Finder
JSONデータを貼り付けるだけで、中の値それぞれに対応するJSONPathを一覧表示する無料オンラインツール。
長くて構造が入り組んだJSONから欲しい値の場所を素早く特定でき、パスはクリックでコピー。APIレスポンスの確認、jq・JMESPathのクエリ下書き、設定ファイルの参照に便利。ブラウザ完結で外部送信なし。
JSONデータの中に含まれる値のそれぞれに対して、そこにアクセスするための「パス」を一覧表示するツールです。長い階層構造の中から目的のデータを見つけるのに便利で、パスはクリックでコピーできます。
JSONPath Finderの機能と特徴
JSONの中の値の場所(パス)を調べる
APIから返ってきた大きなJSONから「この項目の場所を上司に伝えたい」「テストコードで参照したい」というとき、JSONの中を目で追うのは大変です。
本ツールに貼り付けると、$.data.users[0].name のように場所を表す文字列(=パス)が全部一覧で出るので、コピーしてそのまま使えます。
長文で階層が深いJSONほど効果を実感できます。
ドット記法とブラケット記法の違い
同じ場所を指すパスでも $.users[0].name(ドット記法)と $['users'][0]['name'](ブラケット記法)の2種類の書き方があります。
前者はシンプルで見やすく、後者はキーに空白や日本語・記号が含まれる場合に必要です。
本ツールでは両方の表記に切り替えられるので、貼り付け先のツール仕様に合わせて選べます。
大きなJSONでも全パスを抽出できる
再帰的に解析するので、階層が深くても要素数が多くても全パスを抽出します。数千行のJSONでも一瞬で処理でき、目視で追いかけるより圧倒的に速いです。
似たツールにJSONを整形するJSON整形ツールや、TypeScriptの型に変換するJSON→TypeScript型生成もあります。
本番データを貼っても外部送信されない
解析はすべてブラウザ内のJavaScriptで完結します。APIキーや個人情報を含む本番データを貼り付けても、外部サーバーに送信されることはありません。
社内システムのレスポンスや機密性の高い設定ファイルでも安心して使えます。
2つのJSONの違いを調べたい場合は JSON差分比較 をお使いください。
JSONPath Finderに関するよくある質問
配列の中の要素にもアクセスできますか?
はい、配列は
[0],[1],[2]のように順番で指定します。例えば$.users[2].emailは「usersリストの3番目の人のメールアドレス」を指します。ネストした配列や、配列の中にオブジェクトが入っている構造でも正しくパスを表示します。
JSONにエラーがあった場合どうなりますか?
JSONの構文にエラーがあると、エラーメッセージが表示されて解析できません。カンマの過不足や括弧の閉じ忘れが原因のことが多いです。
まずJSON整形ツールで整形すると、エラー箇所が特定しやすくなります。整形が通れば本ツールでも正しく解析できます。
JMESPathやjqとは違うのですか?
JSONPath・JMESPath・jq はどれもJSONから値を取り出す言語ですが、記法が少しずつ違います。
本ツールで出力されるのはJSONPath形式で、Postman・多くのAPIドキュメント・多言語のライブラリで使えます。
jq を使う場合は
.user.nameのようにドット始まり($なし)になるので、頭の$を除いて使ってください。
JSONPath Finderの使い方
-
JSONを貼り付け
左側の入力欄にJSONデータを貼り付けます。APIレスポンス・設定ファイル・データベース出力など、どんなJSONでもOKです。エラーが出る場合はまずJSON整形ツールで構文を確認してみてください。
-
パス一覧を確認
右側にすべてのパスと対応する値が並びます。「ドット記法」「ブラケット記法」の切替もここでできるので、使う場面に合わせて選んでください。
-
パスをクリックしてコピー
欲しいパスをクリックするとクリップボードにコピーされます。全部まとめてコピーするボタンもあるので、資料化やドキュメント作成にも活用できます。
カテゴリ データ形式