1. 홈
  2. 개발자
  3. 쿼리 스트링 빌더

쿼리 스트링 빌더

URL 파라미터를 표로 고치고, UTM을 붙이고, 추적 코드를 한 번에 지웁니다.

내 브라우저에서 처리 · 업로드 없음
전체 주소, 상대 경로(/search?q=1), 쿼리만(a=1&b=2) 모두 붙여넣을 수 있어요.
파라미터 7개
완성 URL
https://shop.example.com/search?q=%EB%AC%B4%EC%84%A0%20%EC%9D%B4%EC%96%B4%ED%8F%B0&sort=price_asc&page=2&utm_source=naver&utm_medium=cpc&tag=%EC%8B%A0%EC%83%81&tag=%ED%95%A0%EC%9D%B8
JSON 보기
{ "q": "무선 이어폰", "sort": "price_asc", "page": "2", "utm_source": "naver", "utm_medium": "cpc", "tag": [ "신상", "할인" ] }

사용 방법

  1. 위 칸에 URL을 붙여넣으면 프로토콜·호스트·포트·경로·해시와 파라미터 표로 나뉩니다. 전체 주소뿐 아니라 /search?q=1 같은 상대 경로나 a=1&b=2 같은 쿼리만도 됩니다.
  2. 표에서 키와 값을 고치거나, 행을 지우고, 위·아래 버튼으로 순서를 바꿉니다. 값은 %EB%AC%B4... 가 아니라 사람이 읽는 글자(무선 이어폰)로 보이고, 고치면 위의 URL과 아래의 완성 URL이 바로 다시 만들어집니다.
  3. 공백을 %20으로 쓸지 +로 쓸지 고릅니다.
  4. 버튼으로 UTM 추가, 추적 파라미터 제거, 키 정렬, 빈 값 제거를 한 번에 처리합니다.
  5. JSON 보기는 같은 파라미터를 객체로 보여 줍니다. 같은 키가 여러 번 나오면 배열이 됩니다.

URL 구조

https://shop.example.com:8443/search?q=a&page=2#reviews 는 다음 부분으로 나뉩니다.

부분 값 설명
프로토콜 https :// 앞
호스트 shop.example.com 로그인 정보가 있으면 user:pw@ 까지 포함
포트 8443 생략하면 프로토콜 기본값
경로 /search
쿼리 q=a&page=2 ? 뒤, &로 구분한 키=값 목록
해시 reviews # 뒤. 브라우저 안에서만 쓰이고 서버로 가지 않음

인코딩 규칙

이 도구는 브라우저의 URL·URLSearchParams 대신 직접 인코딩합니다. URLSearchParams는 공백을 항상 +로 쓰고 * 같은 글자를 그대로 두는 등 옛 폼 방식을 따르기 때문입니다.

  • 글자는 UTF-8 바이트로 바꿔 바이트마다 %XX로 씁니다. 이처럼 한글 한 글자는 3바이트라 %EC%9D%B4가 됩니다.
  • encodeURIComponent가 그대로 두는 ! ' ( ) * 도 인코딩합니다(RFC 3986 엄격). it's (ok)* 는 it%27s%20%28ok%29%2A가 되고, encodeURIComponent만 쓰면 it's%20(ok)* 가 됩니다.
  • & = + # ? 는 값 안에서 구조를 깨뜨리므로 항상 인코딩합니다. 예를 들어 값 a&b=c d+e는 a%26b%3Dc%20d%2Be(공백 + 선택 시 a%26b%3Dc+d%2Be)입니다. 글자 +는 어느 쪽이든 %2B로 쓰므로 공백과 헷갈리지 않습니다.
  • 읽을 때는 +를 공백으로, %2B를 +로 해석합니다.
공백 선택 결과 쓰는 곳
%20 q=a%20b 대부분의 API와 링크(기본)
+ q=a+b HTML 폼 방식(application/x-www-form-urlencoded)

경로와 해시는 허용되지 않는 글자(공백, 한글 등)만 %XX로 바꾸고, 이미 있는 %XX나 / : @ 같은 글자는 그대로 둡니다.

잘못된 % 인코딩

%ZZ처럼 % 뒤에 16진수 두 자리가 없거나, %E0%A4%A처럼 올바른 UTF-8이 되지 않는 조각은 해석할 수 없습니다. 이런 파라미터는 원문 그대로 두고 경고를 띄웁니다. 그 행의 키나 값을 고치면 그때부터 새로 인코딩합니다(예: 값 %ZZ는 %25ZZ).

UTM 파라미터

키 뜻 예
utm_source 유입 출처 naver, newsletter
utm_medium 매체 cpc, email
utm_campaign 캠페인 이름 autumn_sale
utm_term 검색 광고 키워드 무선 이어폰
utm_content 광고 소재 구분 banner_a

UTM 추가는 5개 키를 빈 값으로 붙이고, 이미 있는 키는 건너뜁니다. 값은 직접 채우세요. 대소문자가 다르면 분석 도구에서 다른 값으로 집계되므로 소문자로 통일하는 것이 좋습니다.

추적 파라미터 제거

링크를 공유하기 전에 추적용 파라미터를 지우면 주소가 짧아지고, 누가 어떤 광고를 거쳐 왔는지 같은 정보가 함께 퍼지지 않습니다. 다음 파라미터를 지웁니다(대소문자 구분 없음).

종류 키
UTM utm_ 로 시작하는 모든 키
네이버 광고 n_ 로 시작하는 키(n_media, n_query 등)
구글 gclid, gbraid, wbraid, dclid, _ga
메타·인스타그램 fbclid, igshid
마이크로소프트·야후 msclkid, yclid
틱톡·X ttclid, twclid
메일침프 mc_eid, mc_cid

page, q, sort 같은 일반 파라미터는 그대로 둡니다. 다만 n_로 시작하는 키는 모두 지우므로 사이트 고유의 n_items 같은 키가 있다면 지운 뒤 다시 확인하세요.

예를 들어 ...search?q=무선 이어폰&sort=price_asc&page=2&utm_source=naver&utm_medium=cpc&tag=a&tag=b 에서 제거하면 utm_source, utm_medium 두 개가 빠지고 ...search?q=%EB%AC%B4%EC%84%A0%20%EC%9D%B4%EC%96%B4%ED%8F%B0&sort=price_asc&page=2&tag=a&tag=b 가 남습니다.

같은 키가 반복될 때

tag=a&tag=b 처럼 같은 키를 여러 번 쓰면 표에도 두 행으로 남고 순서도 유지됩니다. 서버가 이를 읽는 방식은 프레임워크마다 다릅니다.

방식 예 설명
키 반복 tag=a&tag=b 대부분의 프레임워크가 배열로 읽음. 일부는 마지막 값만 사용
대괄호 tag[]=a&tag[]=b PHP·Rails 방식. 이 도구는 키를 tag[] 라는 글자로 다룸
쉼표 tag=a,b 한 값 안의 문자열. 서버가 직접 나눠야 함

JSON 보기에서는 키가 반복되면 배열("tag":["a","b"])이 되고, 한 번만 나오면 문자열이 됩니다.

관련 도구로 값 하나만 인코딩·디코딩하려면 URL 인코더, 응답 JSON을 정리하려면 JSON 포맷터, 페이지 공유용 태그를 만들려면 메타 태그 생성기를 쓰세요.

입력한 글은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.