Query Parameter란 무엇인가? URL 뒤에 붙는 정보의 모든 것

작성자:

웹 개발이나 API를 공부하다 보면 Query Parameter(쿼리 파라미터)라는 용어를 자주 접하게 됩니다. 처음에는 생소하게 느껴질 수 있지만, 사실 우리는 매일 검색을 하거나 쇼핑몰을 이용하면서 이미 Query Parameter를 사용하고 있습니다.

저 역시 API 자동화를 처음 공부할 때 URL 뒤에 붙어 있는 ?id=123이나 &page=2 같은 문자가 무엇을 의미하는지 몰라 한동안 헷갈렸습니다. 하지만 원리를 이해하고 나니 API 테스트나 노코드 자동화 도구를 사용할 때 훨씬 쉽게 데이터를 다룰 수 있었습니다.

이번 글에서는 Query Parameter의 개념부터 사용법, 예제, 주의사항까지 쉽게 정리해보겠습니다.

Query Parameter란?

Query Parameter는 URL 뒤에 추가되는 값으로 서버에 추가 정보를 전달하는 방식입니다.

쉽게 말하면,

“어떤 데이터를 원하는지 서버에게 알려주는 옵션”

이라고 생각하면 이해하기 쉽습니다.

예를 들어 아래 URL을 살펴보겠습니다.

https://example.com/search?q=chatgpt

여기서

?q=chatgpt

부분이 바로 Query Parameter입니다.

즉,

  • q → 변수 이름(Key)
  • chatgpt → 값(Value)

이라는 의미입니다.

서버는 이 정보를 보고 “chatgpt를 검색하라는 요청이구나”라고 이해합니다.

Query Parameter는 어디에 위치할까?

Query Parameter는 항상 물음표(?) 뒤에서 시작합니다.

예시

https://example.com/product?id=100

구조는 다음과 같습니다.

URL
?
Key=Value

조금 더 복잡한 경우에는 여러 개를 함께 사용할 수 있습니다.

https://example.com/product?id=100&color=black&size=L

여기서는

  • id = 100
  • color = black
  • size = L

세 가지 정보를 서버로 전달하는 것입니다.

Query Parameter 문법

기본 문법은 매우 간단합니다.

?key=value

여러 개를 사용할 경우에는

?key=value&key=value

처럼 & 기호로 연결합니다.

예를 들어

?page=2&sort=latest

는

  • 페이지는 2페이지
  • 최신순 정렬

이라는 의미입니다.

실제 사용되는 예시

우리가 가장 많이 접하는 Query Parameter는 검색엔진입니다.

구글에서 “자동화”를 검색하면 URL은 대략 다음과 같이 바뀝니다.

https://www.google.com/search?q=자동화

여기서

q=자동화

가 Query Parameter입니다.

쇼핑몰에서도 자주 사용됩니다.

https://shop.com/items?category=laptop

카테고리를 노트북으로 지정하는 의미입니다.

또 다른 예시는 페이지 이동입니다.

?page=5

5페이지를 보여달라는 요청입니다.

API에서 Query Parameter가 중요한 이유

API에서는 Query Parameter를 매우 자주 사용합니다.

예를 들어 사용자 정보를 조회한다고 가정해보겠습니다.

GET /users?id=10

서버는

“ID가 10인 사용자 정보를 보내달라는 요청”

으로 이해합니다.

또는 날씨 API에서는

?city=Seoul

처럼 도시 이름을 전달합니다.

노코드 자동화 플랫폼인 Make나 n8n에서도 API를 호출할 때 Query Parameter를 입력하는 경우가 매우 많습니다.

자동화를 시작한다면 반드시 익혀야 하는 개념 중 하나입니다.

Path Parameter와 차이점

많은 초보자가 헷갈리는 부분입니다.

Query Parameter

/users?id=10

옵션이나 검색 조건을 전달합니다.

Path Parameter

/users/10

리소스 자체를 지정합니다.

간단히 정리하면

  • Path Parameter → 대상 지정
  • Query Parameter → 조건 지정

이라고 생각하면 이해하기 쉽습니다.

사용할 때 주의할 점

몇 가지 알아두면 좋은 사항이 있습니다.

1. 민감한 정보는 넣지 않는다.

URL은 브라우저 기록이나 로그에 남기 때문에 비밀번호나 개인정보를 Query Parameter로 전달하는 것은 권장되지 않습니다.

2. 공백은 자동 변환된다.

예를 들어

Hello World

는 URL에서

Hello%20World

처럼 인코딩됩니다.

3. 순서는 크게 중요하지 않다.

대부분의 서버는

?id=10&page=2

와

?page=2&id=10

를 동일하게 처리합니다.

Query Parameter를 쉽게 이해하는 방법

택배 주문서를 떠올리면 이해가 쉽습니다.

주소만 적으면 어디로 보낼지는 알 수 있지만,

  • 색상
  • 사이즈
  • 수량

같은 추가 정보를 함께 적어야 정확한 주문이 가능합니다.

Query Parameter도 마찬가지입니다.

URL이라는 기본 주소에 필요한 옵션을 추가해 서버가 원하는 데이터를 정확하게 반환하도록 도와주는 역할을 합니다.

마무리

Query Parameter는 URL을 통해 추가 정보를 전달하는 가장 기본적인 방법입니다. 검색 기능, 페이지 이동, 정렬, 필터링, API 호출 등 거의 모든 웹 서비스에서 활용되고 있습니다.

처음에는 ?, &, = 기호가 복잡하게 느껴질 수 있지만, “Key=Value 형태로 서버에 옵션을 전달한다”는 개념만 이해하면 어렵지 않습니다.

특히 API를 활용한 자동화나 노코드 플랫폼을 공부할 계획이라면 Query Parameter의 동작 원리를 미리 익혀두는 것이 큰 도움이 됩니다. 기본 개념을 확실히 이해해 두면 이후 HTTP 요청, REST API, Webhook 등을 학습할 때도 훨씬 수월하게 접근할 수 있습니다.