검색 매개변수
매개변수는 JSON 본문으로 POST /v1/search 에 전송합니다. q 만 필수입니다.
| 필드 | 타입 | 기본값 | 설명 |
|---|---|---|---|
q | string (1–500) | — | 필수. 검색 쿼리. |
gl | enum | us | 국가 에디션(아래 참조). |
hl | string | 국가 기본값 | UI / 결과 언어, BCP-47(예: en, pt-BR). |
tbs | enum | 전체 기간 | 시간 필터: qdr:h(지난 1시간), qdr:d(1일), qdr:w(1주). |
page | integer (1–99) | 1 | 결과 페이지(1부터 시작, 각 ~10개의 오가닉 결과). |
freshness | enum | default | 캐시 제어: default, realtime(신규 강제), cached. 캐싱 참조. |
deadline_ms | integer (1000–30000) | 15000 | 요청별 타임아웃(밀리초). |
국가 (gl)
섹션 제목: “국가 (gl)”br, us, gb, de, fr, es, it, mx, ca, au, jp, nl.
{ "q": "melhores tênis de corrida", "gl": "br", "hl": "pt-BR" }시간 필터 (tbs)
섹션 제목: “시간 필터 (tbs)”결과를 최근 콘텐츠로 제한합니다 — 뉴스와 트렌드 주제에 이상적입니다.
{ "q": "nvidia earnings", "tbs": "qdr:d" }페이지네이션 (page)
섹션 제목: “페이지네이션 (page)”각 페이지는 대략 10개의 오가닉 결과를 반환합니다. 페이지 1–99 를 요청하고, 처음 100개 결과를 수집하려면
페이지 1–10을 반복하세요. SDK 는 페이지를 순회하는 헬퍼(searchPages / search_pages)를
제공합니다.