응답 형식

검색이 성공하면 200 과 JSON 객체를 반환합니다:

{
  "search": "mount everest",
  "page": 1,
  "knowledgeGraph": {
    "title": "Mount Everest",
    "description": "Earth's highest mountain above sea level…",
    "attributes": { "Elevation": "8,849 m", "First ascent": "1953" }
  },
  "organic": [
    {
      "position": 1,
      "title": "Mount Everest - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Mount_Everest",
      "snippet": "Mount Everest is Earth's highest mountain…",
      "sitelinks": [{ "title": "Height", "link": "https://…" }]
    }
  ],
  "ads": [
    { "position": 1, "title": "Everest Treks", "link": "https://…", "block": "top" }
  ],
  "peopleAlsoAsk": ["How tall is Mount Everest?"],
  "relatedSearches": [{ "query": "k2 mountain" }],
  "stats": { "balance": 9988, "cost": 6, "cached": false }
}

최상위 필드

필드	타입	비고
search	string	실행된 쿼리.
page	integer	반환된 페이지(1부터 시작).
organic	array	순위가 매겨진 오가닉 결과.
ads	array?	스폰서 결과(있을 경우).
knowledgeGraph	object?	Google 엔티티 패널(있을 경우).
peopleAlsoAsk	string[]?	”다른 사람들이 묻는 질문”.
relatedSearches	array?	”함께 검색한 항목”.
stats	object?	청구 정보 — 요금 참조.

OrganicResult

position, title, link, snippet, 선택적 date, 그리고 선택적 sitelinks[] { title, link }.

Ad

position, title, link, 선택적 displayedLink, 선택적 snippet, block("top" 또는 "bottom"), 그리고 선택적 sitelinks[].

KnowledgeGraph

title, 선택적 imageUrl, description, descriptionSource, descriptionLink, 그리고 키/값 사실의 attributes 맵.

모든 오류 형식을 포함한 완전하고 항상 최신인 스키마는 OpenAPI 컨트랙트에서 생성된 API 레퍼런스 를 참조하세요.