Google Search API 파라미터: gl, hl, tbs, page 설명 (2026)

Google Search API에서 올바른 결과를 얻는 일은 대부분 파라미터에 달려 있습니다. serp.cheap를 사용한 완전한 레퍼런스를 소개합니다.

모든 파라미터

파라미터	타입	기본값	역할
`q`	string	필수	검색 쿼리
`gl`	string	`"us"`	결과의 국가 (지리적 위치)
`hl`	string	국가 기본값	표시/인터페이스 언어
`page`	int	`1`	결과 페이지 (1부터 시작)
`tbs`	string	없음	시간 필터 (`qdr:h`/`qdr:d`/`qdr:w`)

`gl` — 국가 (가장 많이 사용하게 될 파라미터)

gl은 어느 Google에 접속하고 어느 지역 순위를 받을지 결정합니다. 지원: us, br, gb, de, fr, es, it, mx, ca, au, jp, nl.

-d '{"q": "beste elektroautos", "gl": "de"}'   # Germany
-d '{"q": "melhores carros elétricos", "gl": "br"}'  # Brazil

`hl` — 언어 재정의

gl이 이미 적절한 기본 언어를 설정합니다. hl은 국가 기본값과 다른 언어로 결과를 원할 때만 사용하세요:

-d '{"q": "best laptops", "gl": "ca", "hl": "fr"}'  # Canada, in French

`tbs` — 시간 필터

최근 결과로 제한합니다 — 뉴스, 모니터링, 트렌드 주제에 적합합니다:

-d '{"q": "ai news", "gl": "us", "tbs": "qdr:d"}'  # past 24 hours

값	기간
`qdr:h`	지난 1시간
`qdr:d`	지난 1일
`qdr:w`	지난 1주

`page` — 페이지네이션

1부터 시작하며, 각 페이지는 별도로 과금되는 요청입니다. 결과 100개 받기를 참고하세요.

종합 예제

curl https://api.serp.cheap/v1/search \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"q": "mortgage rates", "gl": "us", "hl": "en", "page": 1, "tbs": "qdr:w"}'

다음 단계

Frequently asked questions

gl과 hl의 차이는 무엇인가요?+

gl은 지리적 위치(어느 국가의 결과를 받을지)를 설정하고, hl은 인터페이스/표시 언어를 설정합니다. 대부분의 경우 gl만 있으면 됩니다 — 국가가 적절한 기본 언어를 설정해 줍니다.

tbs 파라미터는 무엇을 하나요?+

tbs는 시간 필터를 적용합니다: qdr:h(지난 1시간), qdr:d(지난 1일), qdr:w(지난 1주). 뉴스나 트렌드 쿼리에 이상적입니다.

serp.cheap는 어떤 국가를 지원하나요?+

12개국: US, BR, GB, DE, FR, ES, IT, MX, CA, AU, JP, NL — 각각 올바른 Google TLD와 지역 언어를 사용합니다.

Google Search API 파라미터: gl, hl, tbs, page 설명 (2026)

모든 파라미터

gl — 국가 (가장 많이 사용하게 될 파라미터)

hl — 언어 재정의

tbs — 시간 필터

page — 페이지네이션