URLのクエリパラメータとは？仕組み・編集・デバッグの基本

クエリパラメータとは

クエリパラメータは、URLの末尾に ? を付けて続ける「キー=値」の組のことです。Webページやサーバーに対して「どんな条件で表示・処理してほしいか」を伝えるために使われます。

https://example.com/search?q=ノートPC&sort=price&page=2

この例では、q（検索語）、sort（並び順）、page（ページ番号）という3つのパラメータを渡しています。

構造のルール

記号	役割
?	パスとクエリの区切り（最初の1つだけ）
=	キーと値の区切り
&	複数パラメータの連結
%xx	URLエンコードされた文字（日本語・記号など）

日本語やスペース、& などの記号はそのままURLに書けないため、%E3%83%8E のような形にURLエンコードされます。エンコード・デコードはURLエンコードツールで確認できます。

よく使われる場面

• 検索・絞り込み — ?category=books&in_stock=1 のように一覧の条件を表現
• アクセス解析（UTM） — utm_source などで流入元を計測（UTMパラメータ作成ツール）
• APIリクエスト — GETリクエストの条件指定
• ページの状態共有 — フィルタ条件込みのURLをそのまま共有できる

パラメータを編集・デバッグするには

長いURLからパラメータを目視で読み解くのは大変です。URLクエリ解析ツールを使えば、URLを貼り付けるだけでパラメータが表に分解され、値の追加・編集・削除をしてから新しいURLを組み立て直せます。APIの動作確認や、計測タグの修正に便利です。

扱う際の注意点

• 機密情報を載せない — クエリはブラウザ履歴・アクセスログ・リファラに残ります。パスワードやトークンをクエリに入れるのは避けましょう
• 順序や重複 — 同じキーを複数回付けられる仕様もあり、挙動はサーバー実装次第です
• エンコード忘れ — 値に & や = を含む場合は必ずエンコードする

まとめ

• クエリパラメータは ?key=value&... でページに条件を渡す仕組み
• 検索・UTM計測・APIなど用途は幅広い
• URLクエリ解析ツールなら分解・編集・再生成がすぐにできる
• 機密情報はクエリに載せないこと